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PhEf AL£ 
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PRODUCT SUKMAftY. 

1.0 PRODUCT ZUh.Hz?.Y 

POSEIDON is a high-pei iorsiance, Io*-cost terminal server for use on 
NI-Daseti (Ethernet) Local Area hetkCi&Zm It allows a terminal user 
connected via the til to access any of a set of host systems on that "1/ 
and experience throughput ana apparent response time similar to a 
directly connected terminal. In addition, a POSEIDON implementation can 
offer less hcst CPU leading tc traditional asynchronous terminal 
interlaces. 

POSEIDON supports up to eight asynchronous terminals, and is offered in 
two distinct configurations^ One with Modem Control, and the other 
without. The fcodeai Control version Mill conform to DEC Standard 052 and 
alloy remote terminal access through both US and foreign switched 
networks. 

The POSEIDON terminal server iaple&ents the Local Area Transport (LAT) 
architecture, and the operational server software consists of four 

aiodules : 

o LAi Protocol Module. 
o Terminal Pert Hoduie. 
u f*I Fur t #ocul e. 

o User Interlace module. 

The operational server soitxaie is downline loadeo irora a Phase-TV DECnet 
host sjste^ Lsin* the standard kain tenciice operations protocol (MiiPi* 
Wiciocode within the FGSLICCN will control the downline load process and 
handle low-level iithernet maintenance requests. 

In addition, an ispleenentation of the LAT architecture is required on the 
host side of the Ethernet. This may be provided as a host-resident 
driver either Dunoled with or layered upon the host operating system, or 
as a free-standing LAT host server wlich communicates with existing 
interfaces on the host system. host-resident drivers are currently 
planned lor VAX/VHS, RSX-11M/M-PLUS and TQPS-20 systems, and a LAT host 
server ("Reverse Poseidon") is planned for support on other host systems. 

This document describes, in detail, the POSEIDON software features and 
operation including microcode functions, and provides a summary of the 
LAT architecture used to ccfc&unicate with lasts. 
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EMVlKCfcK^T 

2.0 fcNVlkGKtoEfli'i 

2.1 Users 

The POSEIDON software may be utilized by any Terminal User requiring 
access to a host computer* feuch oi the software functionality is 
transparent to the user: the main task oi transporting terminal data 
back and forth between a host system and a user terminal requires no 
additional user interface. The user, therefore, requires only the 
knowledge of the host processor command language (or other interlace), 
and the ability to connect to the host processor. 

There is a limited 'Local Fode* command set provided by PGSfilOGa which 
alloys a user to connect to and disconnect iro» a host systeis, set and 
show terminal parameters end display host information* A HELP command is 
piovideo, alicainy tuii use or the terninai witnout yritten 
documentation. The level oi complexity oi connecting to a nost system is 
about the sacse as that using traditional switching devices. 

The capability cf automatically connecting to a pre-defined host system 

is provideo, evoiomg the Local fcode coma ana interlace entirely. An 

' l X c K - z; u c f r ' "* t v. r '-' it: V! r o ^rovi'?e**> c ! i t i v. 1 1 i r. o t "h e reed f c r !^ a nu <s l s^ e e d 
specif i cation. 

During nora.ol stiver cj-erations, ore oi the local terminals say be 
enabiea as 'Pnviiegec* roi use by a *lei«inai Manager*. this 
password-protected interlace alloys tae speciiicaticn oi server 
parameters and the initiation of saint en snee processes, and is the only 
network management interface provided yith PGSEIDCN. This interface is 
also used to specify user accessibility to host systems. 

The Terminal manager yculd typically be responsible for the day-to-day 
operation of cne or ascie PCSE10LM units and associated terminals, and 
would be expected to manipulate all non-netyork-related parameters 
without assistance. Supervision ot th€ Ethernet network, containing 
peseioers and host systems, wcuid be the responsibility of Network 
(end/or System) Managers. These individuals would be responsible for 
defining network (LAT) paraaseters for the PGSEIDOfcs and hosts, and for 
relaying this inferoaticr to the individual terminal managers. Of 
course, in certain installations, the Network and Terminal managers may 
be the same people. 



Am Z h atUtut ti 

ihitj te lease ot trie L«T seiver sortwace is designed to run on trie 
PCSlIDCN h3rdwcre exclusively. The hcrcware configuration consists of 
the iollowincj elements: 

u 08OOC H^icrcpLOcesscr (10 ^uz, turning at 7.35 Mdz) 

o 16 n.B V.QV (d KB for load/maintenance nicrocooey 10 KB for 

diagnostics) 
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ENVIRONMENT 

o lit- KB khh 

o A PkGft containing the Ethernet accress, checksum and test pattern 
o 512 bytes of Non-volatile HAM, for stcrage of 'Peroianent* parameters 
o 4 26b.l DUAHTS with RS-232C/CC1TT V.*4 interface (8 lines) 

o ANL/I40STEK LaNCE and £IA Ethernet Chips 

A nienioiy layout is shown ir Appendix E. 

PGSLIDQN supports most asynchronous ASCII terminals up to speeds of 19200 
bits per second (bps) in Line Mode/ and up to 9600 Dps in Block "ode. 
DIGITAL terminals specifically supported by PCSEIDCN include: 

o LA12, LA50, LUGO 

o LA120, L/H80 

o LA34, LA26, LA38 

o ^ThO, «152, Mlbx as VTd2/ yTox as $\^l 

o ^TIOQ, ¥1101, ¥1102, VT12b, VT131 

o VT220, VT240 

o GU;i as VT100/ Vl'lfcC as VT100 

o aA1*NLC'» 10C/ DECaate II and PRL7325/35C as VT100 

I C- *J 4- J. 4-.' i_ ii * .A .1 i. JUJ J Ut I Ctl il. i,ll(i AO Lt. ti I ;_, L. » 1 V. i. i." L !_ A-< U Ui . / Oil- _r t? J. Vr 

chaiLct ers • The tfoaea; Control version of POSEIDON will support 

lull-duplex fiiodeiis conforming to the *tb-^3i-C and CCITT fc.24 standards/ 
mciuoir.^ CcITI V«.13 node^s. ^ode^s explicitly supported are: 

o bELL 103*i 
o bF.LL 212A 
o Di«ul/DE02/LF03 



2,3 Software 

The operational softyare runs on the FCSEIION haro*are as a stand-alone 
system: no other software is required/ not aay any other software be 
layered upon the server software* This software is doynline loaded frost 
a Ehase IV DCCnet host supporting the standard maintenance operations 
protocol <^GP). Therefore, GNE active Phase IV DECnet host system on the 
local Ethernet is a ^inirnuir requir eiuent for PCSEIDC& support* 

LaT support is zlso rttjuiiec on tne host side of the Ethernet/ and this 
can be in the forB» of a host-based L/T driver/ or a LAT host server 
utilizing existing host interfaces. It is planned to ship a host-based 
LAT cnver as t layered product supported by VAX/Vfc3 ¥4.0. This product 
is descriheo in the 'VAX-11 LAT* engineer! ro, plan (IBS). Future support 
is also planner! for the .-'SX-llM/^-f'LUS and TOES-^0 operating systems. 
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2.4 Set vices 

The PuStlDO^ product is engineered to be fully customer installable. The 
PGSEIDCfc software uiil be shifted (as required) kith the hardware on the 
appropriate media for tiie load hcst(s). A separate Software Installation 
Guicle will also oe snipped. Upon receipt o£ the FOSEXUUft product, it is 
expected that the software roedia and installation documentation be given 
to the system aianagerCs) of the appropriate load host(s) for 
installation. Ihe POSEIDCK hardware woulc then be installed by tne 
customer or optionally by a Field Service representative. 

The POStlUGN software is tuily supported by DIGITAL for 90 days, after 
which support services lay be purchased. Planned services include 
Software maintenance Service and EJSIC Support using the Telephone 
Support Center (TSC). Details on software support strategy way be 

obtained in Rtlticiice 4, Sei viceaLili ty iieguir eaten ts Document. 



3.0 bQtTtikkE CAPABILITIES 

3.1 GFNfKAL DESCRIPTION 

s typical local area netwerk configuration might consist ot a nunfeer of 
terminals conntcieu to one or usort HG^LiLuk terminal servers, which are 
in turn connected to the hi. Also on tne hi may be a number of host 
systems with LA! host software support. 

I terminal user say, usir.* a Local ^oce co&mand, display a list of hosts 
to which he/she is authorized to access. Ibis authorization is specified 
by the Terminal Manager using the Privileged Local Mode interface, and is 
co-ordinated with the System Manager(s) of the host systems. 

A user aiay then CONNECT to and communicate with any one of the authorized 
hosts and experience tunc tionali ty, apparent response time and throughput 
similar to a directly connected terminal* There may be any number of 
PGStlDGft servers and supported hosts residing on a single HI, within 
Ethernet limitations. 

Gnce a terminal is logically connected to c host, west applications that 
wouid normally be supported by the host operating systew are supported by 

?t3Sfc.IDO&. This includes 'interactive* terminal mode applications at 
speeds up to 19200 bgt and flow-cent to lied block-Bode applications at 
speeds up to 96C0 bps. Operation of 'passali* fclock-aode applications 
(KeGIS/PHG-350 tile transfer etc), and irterprocessor communication are 
supported, provided that a higher level protocol (eg: ODCHP) is in 
operation to detect and cortect any doU ov^irun conditions. 

Keiote terminal operation is possible with the fcodeui Control version of 
PtiSfcluXN. Thii mccem ccrtrci supports botr US and foreign switched 
network 



. _! • 



The server sortware is logically broken town into four elements, to 
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SOFTfeM<E CAPABILITIES 

facilitate tiie possiole use ox LAI on other server products- These 
elements die no* descrioed: 

o The LaT Protocol Module - This aodule is responsible for 

implementing the server side of the LAI protocols and can be 

considered the 'base* of the server software- The Protocol Module 

is responsible for: 

- Initializing PGSfclDCiN hardware/ LAT data structures and 

buffers » 

- Implementing the various ti&er t unctions. 

- Controlling the server Circuit States and Slot States. 

- Accepting taiudnal input Lulieis iioa* the Terminal Port Modules 
and pcssing thea* as transmit buffers to the 'NI Port Module- 

- Accepting M receive buffers ircf» the NI tort Modules and 
passing theus as output Duffers to the Terminal Port Module* 

- ^a i n t ei p t r*;? p cat? Hpsp nf prr^FiiHip hc?f systems. 

- J'!tinQling all Connect and Disconnect requests, including 
*utoccnnecty anc issuing correction status aessajes. 

- Servicing ail maintenance requests from host and user. 

- writing to the MV Ran. 

o The Terminal Port Module - This nodule interlaces between the 
Protocol module and the terminals themselves via the 2681 DU A^TS. 
It is responsible tor: 

- Automatically detecting terminal speed. 

- Accepting input characters from the terminals and placing theai 
in the LAT buffers in main ice&orv. 

- Detection and handling of flo- control characters, the Local 
Switch Character and cfiEAK. 

- Handling Local Fode inputs echo, processing of control 
characters and passing entire coaiaands to the User Interface 

module. 

- Handling local output, including liou control/ status aessages 
and notification upon output completion. 

- Accepting L*T output buffers iron main aeniory, and outputtiny 
characters to the terminals. 

- Handiinc? of moderr control. 
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SGFTfcAirfE CAPABILITIES 

u Trie Ul Pott Hoduie - Tnis module interlaces between the Protocol 
Houule arm the Nl controller, as is responsible tor: 

- Accepting LAT transmit buffers, formatting them into Ul frames 
and transmitting then to the connected hosts over the NI. 

- Receiving Ul Frarres, filtering urfcanted frames, and notifying 
the Protocol Module upon completion* 

- Maintaining Ethernet counters anc providing mechanisms to read 
and zero them. 

o The User Interface Module - This module handles both the 
Non-privileged and Privileged Local fcoce interfaces with the user, 

and formats status tr-essao.es* It is responsible for: 

- Parsing and processing all user co«»ands entered *hile a 
terminal is in Local ^ode. 

- Sotifying the Protocol Module if a CONNECT, DISCONNECT, 
INITI/LlZh ci LCCP Comaianc is entered. 

- Co-ordinating the updating of dynamic end permanent parameters/ 
depenuinc, on the current server, connection and privilege 
states. 

- Ccnoucting terminal tests. 

- Formatting and initiating output of status messages. 

During normal operations, a POSLIDGfc terminal server is not considered a 
DECnet node, nor does it interface uith DECnet. LIT hosts need not 
support DECnet, but if they do common DECret and LAT parameters (eg: 
Host Name) should De cotrpatiole. Certain network ifianageaient functions 
provided with DECnet software may be utilized with POSEIDON. Section 
3.1.17 oescribes POSEIDON support in this area. 

The following sections oescrioe the external software functionality 

provided by POSfclDOf*. 



3.1.1 Local &ode Operation - 

LOCAL ^CDL is a means of communication betueen the terminal user and the 
POSEIDttft unit, ana is available to all interactive terminals except those 
lenrieo to nave a di-u ic*1 tL huSI system tsee section 3.1.b). 

Local "ode may cc operated in a PRIVILEGED or NGN-PH1V ILE'GED state: the 
rjon-pi ivil eyeo ^tate is utilized to connect arc disconnect the user's 
teririnal to oi item a hobt system, set and aho* teminai parameters and 
display a list of authorized hosts. This interface is available to all 

users. 
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Local Kocie Operation 

The privileged state is password-protected, and is utilized to connect 
and disconnect any POSfclLGK terminal, set ana shou any terminal's 
parameters, set and shofc server parameters, perfcin? server initialization 
and maintenance functions. Lilly ONE terminal may be privileged at a 
tirae. The privilege may be "stolen" iio& cne terminal to another if a 
terminal port becomes disabled tor soee reason. 

For terminals with a DEDICATED HOST defined* no Local Mode operation is 
possible. for these terminals, user operation is identical to that of a 
terminal connected directly to a host systea. Aisc, if a "terminal" type 
is designated as "CTbEK" (see section 3*1.12), or il it is defined as 

"3&RiTE_CNLY" or "t<Eiii_0NL *", no Local ^ode operation is available. For 
these terminals, connection to a host is achieved using AUTGCONNECT, or 
the CONNECT TERMINAL comirard in privileged local jrcde. Local £ode is 
discussed in detail in Section 3.3. 



3.1.2 host Mode Lpetation - 

"' , f '• , . ■, - '- "" '. ■*- ,'; r- - 7 " - J i ■■ , r- *- , • r p rr <t. » j 1- i j- -s +- r I ♦" *•> ~i <K r*. *' f i? '5 ■»<-♦•» Wi "3 Tt ."I 

. > O *J U i . C- *" <- i,llui» i i-u --. t- »- -4. ii. 1. A i C A. UUt.1 v >^ otilii.Ul.l .. <_; O \- -* 1 --■ i i ..1 - i \y iJ. t _ Jf J i. --- n: _/ <J * i ■ i 

is the mode that kill ne utilized tor mcst ot the time. Ail functions 
supported by the nost system tnat fcoulc lave Leen available using a 

'■iiect local interface bit available to the f'CSEICGfc usei. 

dost rtode is initiated in one of the lolloping ways: 

o Following a CQ^NtCT command from Local Node, and a connection was 

successiul iy ea tonlished. 

o Folloying FGSEIDCN initialization aher. AUTOCCNhECT is enabled for 
the terminal, a default host is definec, and a connection was 

successfully established. 

c following a host initialization when iUTLXONKECT is enabled for the 
tetfliinals and a connection *as successfully established. 

o Following a Local «ode KE3U&E coisirand, i*hen a connection uas 
established priot to entering Local rtcde. 

In Host f *od£, all characters typed -are sent to the host and character 
echo (if any) is perlor&ed by the nost. All control characters and 
escape sequences are passed tc the host yithout interpretation EXCEPT the 
following: 

o The XCFF and XLM characters - if outptt flofe control is enabled, 
these characters cause lirffiediate Hot control actions on fne 
terminal, end ai ^ k as^ed along to the host as well. p loy control 
can be enabled and disabled by the user as desired. In addition, 
thfc nost a^stens iray dynamically disable and enable flow control to 
perjsit certs in interactions such ci file transfers without user 
intervention. 
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o The Designated Local 5*itcb character (or the Break key) - This 
causes an aOFF to ee sent to the host, and Local Mode to be 
immediately entered on the terminal. 

Characters such as Control/0, Controi/Y etc are host-specific 
iiBpie&entations, and are processed exclusively by the host. 

fchen a terminal is in host Hode, local (f GSEIDON-originated) status 

messages &k\ apt ear in the lollowing circumstances: 

o If the host disconnects the terminal tor some reason. 

o It 3 privileged FOStlLUN user terminates the session (DISCONNECT 
TFRVINAL or INITIALIZE). 

o It a communications timeout or iatal protocol error occurs yith the 
host. 

Status aessages ate delivered 0&L¥ to the same terminals that alloy Local 
Mode. (iEi IMPLICATED FLST, "OTFEF", "R^AD^CMLY" and "^RITE.ONLY" 
terminals do not receive local status messages). 



3.1.3 Autooaud Capability - 

Autobaud is a means by which the PLZE1DCH uirt can determine the input 
(and by assumption output) teminal speec oi a particular terminal, and 
adjust the current terminal parameters to that speed. If input and 
output speeds oi tht terminal are different, autooaud will not function 
correctly. 



The autobauu feature is implemented by posting 




This teature is particularly useful tor eioeem-controlled terminal lines. 
Autobauo is erabieo by default, and, then enabled, overrides any 
previously-defined terminal speed. 

The autobaud capability available to FLStlLiiN aiay be restricted because 
ot certain characteristics ot the UAHlb. iince these characteristics are 
unsreciiied/ the extent oi the autocall capability may be determined only 
ai t er img 1 en. en t a t i on • 

3.1.3.99.1 Extent of Autofcaud Functionality to be defined after 
implementation 
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3.1.4 Local Switch Character - 

Since tnere are t*o user §oces available at the user's terminal (Local 
and Host modes), a «ay tc initiate each racde is required. Entering Host 
l^ode is discussed m section 3.1.2. 

To enter Local froce while in Host mode, the 'Local Switch Character* say 
be typed in. any ASCII character CR the creak key &ay be defined as the 
local switch character in a SfcT IfcRHIhkL ccaaiand. The aefault is the 

t. je\ ij t\ i\ Key. 

Upcii entering this character, an XOFF character is sent to the host, the 
Host Hode session is suspended/ and Local &ode is enabled on the 
terminal. 



3.1.5 lioot Access Control - 

?h ? tyric:?! e t H ?rnet envircn^ent T37 cert? in literal !y 'hundreds* or host 
systems and terminal servers (in addition to other servers). These 
servers and hostib may ctc^i many different organizational components of 
customer sites, each of khich nay need tc access only a s&all subset of 

the services. 

A facility is provided tc assign ACCESS CODES to both hosts and 
individual terminal users. On both the eGSEIDCft and affected host(s), 
access codes itjay i>e entered only by a ^iiviieyeo user. Access codes 
provide both protection and a Ecre efficient directory service (see 
section 3.1.7). One or acre access codes ere assigned to each terminal, 
and one or more access codes are assigned to each host. If any ONE 
access code is assigned bcth for the terminal and host, then the terminal 
is authorized tc access that host (and CGMfc£CI requests are honored). Up 
to 12b access codes may be specified, numbered Q - 127. 

In addition/ only the hosts for yhich a particular terminal is authorized 
to access are shoi»n in the SHGV F.GSTS display. 

As a further method of access control, hosts aiay reject connection 
requests on a per-ssrver or per-terfrinal basis, based on other attributes 
passed to the host at connect time, or for any reason at all. The 
overall philosophy of access control alleys the local PLSEIDGN Terminal 
Manager to define the environment for the terminals for which he is 
responsible., and alloy the host systea. to accept or reject this 
environment at connect tifise. 
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3.1.5 Host rtaaieb - 

Fveiy host that supports the LAT architecture must be assigned at least 
CKiE name/ ano this in&t na&e must Le unique within the local network and 
not change while the host is accessible. Masses may be froffi 1-16 
characters in lengthy arc contain the fcllcwing characters: A-2, a-z, 
0-9, $ (dollar) and _ (underscore). An example oi a valid naae is 
"LA T$H0ST_1". Lowercase names are logically equivalent to uppercase 
nawes. 

Host naaes are utilized in CGAi^ECT commands, ana are displayed in the 
SHOW HOSTS command/ and are the only means ot referencing a particular 
host system. 

To support VAX clusters/ the capability exists to assign up to seven 
dddi tional gioup iid^es Lc a host system, ana allow different syste&s to 
share names* Together with each host naffie, a host RATING from 0-255 is 
also assigned. When a CGNNhCI request is issued, the nost with the 
Highest rating FGk THAT hhfrt will he selected tor connection. Specific 
hosts may be referenced by their unique nana under all circuimstances. 

? or exa»plH/ e hoist «»py be assigned =» unique n^we (SMOG)/ and have two 
group na«ies (COHPUTfcr ar-d VAX) that are shared awong hosts. The hosts 
will conspire anon^st themselves as to which has the highest rating for 
the names COPPUTfcfc end VAX, so that the user requiring access to any 
CLiMriiTt.h may siffp ly say LLA&ECT hUii'i CU^fUliH and will be connected to 
the CUfci-UTiifc aim trie highest rating. r or those a- ore demanding users who 
require access to a specific host, CCfcNECT HOST SttAUG may be entered. 

It is expected that bests sharing names will regularly adjust ratings in 
such a way as to evenly distibute the processing load. 

II a group na&e is specifiec m a CONNECT command, or is defined as a 
Preferred or Ledicateo host, the FliShlDGN software will make every 
attempt to connect to, and maintain a connection with, one of the hosts 
in the group. If, for example, the highest-rated system in the group 
does not respond, or tecsnirates a connection, the FCSEIDOtf software will 
automatically at tempt to connect to the next highest-rated system within 
the group. This will continue indefinitely until a connection is 
established, cr a L-7SCC&&ECT command is entered in local mode. This 
feature is called Autoconnect (see section J.1.6) and may be enabled or 
disabled on a per-ter*>inai basis. 

If an existing connection was nroken, and coasfiiuriications subsequently 
established with a different host in the group, a N£$ connection is 
established, and no continuation of any system activity from the old 
connection is transferred to the new. If and when the host operating 
oy&iew iUi>^otU atiiiiuii recovery, the Fu^r-iuGN soitwdfie will ue updated 
(if necessary) to also support it. 
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3.1*7 Host Directory Service - 

At any given tine/ a terminal user Bay aist to kno« tafia t host systems are 
currently available to run;. The SHLfc HOSTS coajtand lists all the hosts 
that the user is authorized to access/ and they are displayed by name. 
For any name that is a group name, a list of hosts in that group yiii he 
displayed* 

The display will also consist of host identification and status. The 

status jp ay be one of S£/CBAfiLE, UKR tACfcABLfc., OVERDUE or DELETED. Only 
those hosts designated REACHABLE or QVERDUfc nay he accessed by a CONNECT 

command. 

The host directory service is maintained as a result ol host systems 
informing servers or their presence at regular intervals of 10 seconds - 

3 fcinutes. II these atsbcges are receiver regularly/ and no connections 
time out or terminate abnorifially, the host status is aaarked as 
*KEACHAiiL£*. If POSEIDON has not heard ir Ctfi a nost for 6-3 minutes/ the 
host's status rs changed Irosi KMCHAbLfc to iillkBDVE, alerting the user 
that the host n^ay be coun. CONNECT requests are honored if the host is 
eitner in KLACIiAdLS ot uWiifiuUh status. 

If no information is received fcr j0 minutes, cr a connection aas 
terminated abnormally, the status is changed to uwhEACHAbLt. and caay no 
longer ce 3ccesse<3. If no information ii, received lot 24 hours/ (or the 
host oata base becomes tuiij the host is deleted iron? the data base 
entirely/ and nc miorniaticn anout it is retained. 

More detailed information about a specific host asay be displayed using 

the 'SKClfii IIGST Lott_nair.e' cotes* and* Host counters bill also be included 
in this display. 

The privileged terminal user a ay SHLfc ALL fcOSTS/ and receive a list of 
the hosts that ALL ol the terminals on the PGSEIDCN Bay access. It none 
of the terminals on a POSiilDON «ay access a particular host system, no 
data about that host is retained/ and hence it cannot be displayed. 

POSEIDON reserves 30 KP ol uemoiy for storage ol host systems and names. 
This aiitount yill support the storage ol over 2 00 host systems/ and 5 

group names. II an Lthernet contains jacre than 200 hosts, the 
tero ina 1/ system managers should assign access codes appropriately/ so 
that lncividual PCSF. ID0N units kill not require access to more than 200 

hosts. 



3 • 1 . b autocounect tapauruty - 

AUTuCONNfCT is a iunction that ou toaatical ly connects a user terminal to 
a host sy^iteiT *htn connection laiiutes occur/ or upon pQSFIDLN 
initialization. 

if AUTCCGNNhCT rs enabled* out no DtDlCklhl or PR£«ERHEu host is defined/ 
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then Autoconnect operates cniy upon abnorici termination of a connection, 
or upon iailuro to establish a connection. (An abnormal termination is 
any disconnection that is KC1 because of a LISCGNNECT, INITIALIZE command 
or host LUGCui.) Upon such termination, the PCS11DGN «ili attempt to 
reconnect to the same host. Attempts to reconnect *ill be asade at 30 
second intervals, and continue incieiinitei y unless local §oae is entered 
by the tser. 

If the terminal had been connected to a GRCUP host, Autoconnect functions 
slightly differently u^oo abnormal termination. Instead of trying to 
connect to the same host system, attempts hill be made to connect to 
another host kithin the group, and so en through all the hosts in the 
groun until either a connection is established/ or local mode is entered 
by the user. 

In addition, A LiuU LCk'itu iiub'i or i Hct thk&U iiUSI &ay ue. specified with 
Autoconnect. When either of these art specified, Autoconnect will 
attempt to connect to that host upon FCbfclLGN initialization, or when a 
CGhNECT coManc (yith no host name) is entered, as well as upon abnormal 
termination* 

T !' -.: r^-iiCutu:' iojt i~ . r r -cif ie-^iy. :utoccr.n€ct villi nttercpt to connect to 
that host *toi ever*, until the connection is successfully estaclishea. 
This cent lgurat ion is designed to simulate a local terminal interface 
t;>actiy, and h^nce thete is no Loccl *-.-oce or PCSElDCK-initia ted status 
ffltSbaoeb. If the host goes down, the vset *iii only notice a lack ot 
response, just like a local system. however, autoconnect yill still 
attempt to re-connect to the host (or another host in the group). 
Autoconnect is cifcays enaolee when a Dediccieo host is specified. 

If a Preferred host is specified, autocennect fciii also attempt to 
connect to the host 'for ever*, unless Local Node is entered, ishen Local 
Node is entered, the autoconnect procedure is suspended and the user jsay 
then SBGk H0S1S or CGKNECT to another host as desired. If a connect to 
another host is not perroriRed, Autoconnect may be restarted by entering a 
fi£SUH£ command. Status lessaqes aay re issueo to terminals with a 
Preferred Host specified. 

If Autoconnect is disabled, ail connection tai lures result in an error 
uies£>dye being displayed, and Local fcode being entered on tne terminal. 

The LOGOUT corrirerc troy be used to disconnect froin the host and also exit 
out 01 Local cioco. Upon entering this costuarid, the Autoconnect procedure 
halts and is not restarted lentil a LG&0& occurs. 



3.1.9 vlohi Control - 

Ficfe Ccr.ti.cl is a !*eans by hhich a receivirg station (Host, POSFIDON or 
terminal) may innioit transmits to trial station until tne station is 
adequately btfiered to receive the data. kith floi* control, the 

[ossibility of cato cveiicuns is n'iniaiized (or eliminated). FGSE1D0N 
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tosesses an extiemely flexible and effective tioy control iaechanisa*. 

Floy control between the PCSEIDCN and the host system is managed at the 
L£T protocol level by a creeit sche&e. Receiving stations, when thay are 
prepared to receive data, pass a credit to the transmitting station* 
Credits are maintained en a per-tericinci basis and are passed in slot 
headers (see section 3.2.2). Transmit anc receive credit counts are 
maintained by both stations. Transmits may only occur when transait 
credits are available. This flow control is bi-directional and is always 
enabled. 

Flow control betyeen the I CSEIDON and the terminal is achieved using 
special characters termed *XGFr* and "%ufr*. «hen a station (POSFIDGJi or 
TERMINAL) receives an XGFF from another station, it must inhibit all 
transmits to that station until an XCM is received. There is usually a 

siiiall *y.race' period fur Lht station to coaply: iu»>hiDQ« will allow up 
to 10 extra characters to be received fro& the XGFF'd station before data 
overrun occurs. 

Since this tors, oi flow control utilizes special characters, its use may 

not always be desired, especially it "binary** data is being exchanged. 

^OSMOPfc' r-'Hofcr: t^f ter**ir?i u^^r tc sp°ci f i<~? t iy en? K ie cr Usable input 

(iroffs terminal) or output (to terminal) flow control. 

Certain situaticns require that flok control be dynamically enabled and 
disabled. Instead oi iequinny the user to repeatedly enter conwands to 
achieve tins, the capability exists to alio* the host to dynamically 
enable or disable flow control. Since both the Terminal User and host 
system can enable or disable liow control, the following priorities are 
in place* 

State set by User Metier, Final State 



Disabled User Disable Disabled 

Disabled User t'nable hnaoiec 

Disabled Host Disable Disabled 

Disabled host triable disabled 

Enabled User Disable Disabled 

Enabled User Enable enabled 

enabled Host Disable Disabled 

Enabled Host Enable Fnahiec 

The user coinanc dill always operate ana override any state set up uy the 

host. 

Flo* control is enabled by default. The XCFF and XGN characters are DC3 
(hriA 13) ana Ui {iinA li> respectively. 

In addition to Tioy control, LLSS NCT IFI CaTlLi* ?ray be enabled on a 
per-tenr ina i Lcoi^. If: enabled, the <>iL character will oe output tor 
eacn chcidCter iost because of insufficient buffer s^ace. This alerts 
the user that the character must be re-entered. To effectively utilize 

flow control, the following set-up is reconmanded 2 
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Line mode terminals Llocx mcde terminals 



output Fiofe Control Enabled Output Floy Control Enabled 

Input tloi* Control Disabled Input Flo* Control Enabled 

Loss Notification EnaBleo Loss wotirication Disabled 



3.1.10 Modem Control - 

The ttodeni Control version c£ PCSEIOLN conforms to DEC Standard 052/ and 
supports the following 3 fcrrrs of Kcdem Cortrol: 

o I*o-«ta> siftui toiieousy oyfliiisc tr ical (Full-Duplex) 

o Tto-fcay simultaneous, 4synsffietriccl using Special Cable 

o Data Leads only ^ode. 

This conforms to the EI A MS-232C and the CCITT ¥.24 standards for 
tuii-du^iex sioceits, inducing CC1T1 V.^3 ffiooeais using the secondary 

ch^nne ! . u i ! f-«u^ ^ «v ^o^cf control if V*.jT svp"ored» 

All calls are originated iroi« the terminal into the PG£EIDGN> dial-out 
arc? roden; speed select are not supported. 

Ine sup^oi ted acaei signals are; 

Name Pin Description 



BA 




Bfc 


3 


CA 


4 


CB 


5 


cc 


o 


AB 


7 


CF 


n 



AA 1 Protective Ground 

Transmitted data 

Received Data 

Request to Send 

Clear tc Send 

Dataset Keady 

Signal Ground 

Received Line Signal Detector 
CD 20 Data Terminal Read^ 

Modems specifically supported are Pill 103d/ BELL 212ft, DF01/2/3. 



3.1.11 Terminal Support - 

Since f- fib F 100*1 performs no intei nretat ion o J: data characters, all 
asynchronous ALC1I terminal devices si tt oited Dy the host terminal class 
driver (up to a sr-eec c£ 1S20C bps) are su^^orted by PGSFIDGN in Host 
Mode. See section 2.2 for a list of teraurals explicitly supported. 

?iocK irode terminals at steeds u£- to 9LQQ D£s are also supported. 
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provided that they honor m^ut ilou cortrol or utilize a higher-level 
Protocol to detect anc correct any data overrun errors, 

PuStlDCk supports both 7-bit and b-fcit character sets in host mode* To 
support a 7-bit cnaracter set (ASCII)/ the terminal aad the POSEIDON aay 
be set up to exchange either 7 or 8 bit characters (teraiinai and Poseidon 
must be set up the same way). It set up to exchange 8-bit characters, 
bit 7 will Le a zero. The parity bit (ii enabled) is NOT sent to the 
host m oit 7, and the host must NOT output a parity bit in bit 7- 

II an 6-bit character set is used, both terminal and POSEIDON must be set 
up to exchange B bits (eitner yith or without parity). Ail eight bits 
are sent to the host, and all 8-bits received fcoai the host will be 
output to the terminal* 

Tne Local ?uue interface functions only *i th tne 7-Dit ASCII character 
set. bit 7 in all local mode input is iyrored, and is zero on all local 
mode output- kote that this places a restriction on host naaes/ 
iuentir ication etc, which »ust utilize only 7-bit JiSCII. 

The specification oi terminal parameters such as terminal speed, number 

ot stof bit* elr #«ts t hp oopa fro* local *oc? vsim tnr ^*-:T TiiPflKAL or 
UtFlNb TFhfc'iML coHhrands. ixo host-tased specification of parameters is 

supported. 



3.1.12 Terminal Parameters - 

Several options that aay be set on a per-terisinal basis have been 
described in the precedire; sections. Litter parameters *hich may be set 
on a ^ei- terminal basis are as follows: 

o In t ut Terminal S^eed: The Input (Terminal to PCS£IDGM) terminal 

speed may be specified. Legal values are 50, 75, 110, 134, 150, 
200, 300, tOO, 1200, 1800, 2000, 2400, 4800, 7200, 9600, 19200 
bits/second (bps). The default is 96€0« 

o Output Terminal Speed: The Output (PCSEIDGN to Terminal) terminal 
speed may be specified. C.eqal values are 50, 75, 110, 134, 150, 
200, 30C, cCC, 12CU, .1800, 200C, 2400, 4600, 7200, 9600, 19200 bps. 
The default is 960C. 

Although 9b00 is a default for terminal speed, autobaud is also 
enabled by default. The 960C default only becomes effective if 

aufooauu is bisaoltu. 

For ,j character size ot eiyht bits, no parity bit, one start oit and 
one stop bit, the chciacter thrcucnpit in byt.es/seccna is one tenth 
of the tern trial spetd. 

o Character 6ize: This a;ay be 7 or 8 bits. The default is 8 bits 
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which can be utilized on aost terminals. Support of 5 or 6 bit 
codes is not provided. 

o Parity: Polity nay be enabled or disabled, and if enabled may be 
even or ode. The default is parity disabled. 

o Number of stop bits. The default value is t«o. Legal values are 1 

and 2. 

o Type: Terminal Type nay be defined as iiARDCCPY, SGFTCGPY, AhSI and 
OThER. It HA8DCGPY is specified, all Local &ode output will be 
compatible yith hardcopy terminals, arc the delete key will echo the 
deleted character between slashes. 

if SQFTCQPV. is specified, the delete key (in Local Node) will erase 

the deleted character lioax the screen, ana oac&space the cursor. 
This applies also to 4KSI. 

it AhSl is specified, the tiTiOO ANSI escape sequence support will be 
assumed on Local, f-oce output (Note; VT52-coaipatible terminals are 
net kUhl type). 

It OThcP is specified, it is assumed that the device is not a 

terminal at all, arc Local Ecoe e«C statu* messages yill not be 
ercbiec* or. the device. tormecticrs irust be performed via 
Autoconnect, or iro& the rriwilegeu Local Moae interlace* 

Read and/or write access may aisc be specified as a TYPE parameter, 
and may oe H KEAD_UK11 1", "READONLY*' or "£R IT£_0fcLY"„ The default 
is "RZAD_KriIE". Thii, parameter is opacified by a privileged 
command. Local #ode and status messages are enabled only for 
"PEAD^KRITf" terminals. In addition, output is disabled lor 
,l R*.Au_UNLY" devices, ana input is disabled trosa * , &RITE_ONLY" 
devices. 

o access Codess Access Codes authorize the terminal user to access 
hosts containing at least one of the same codes. This parameter is 
specified by a priviieG.ec ccaroanc. The oefauit is access code zero 
enabled (ell others disabled), yhich will alloy access to all hosts 

yhich also default to access code zero. 

o Name: a na?*e of up tc 10 characters may be specified for each 
terminal. The name is specified m a privileged SET TERMINAL 
command by the Terminal Manager, and ji-ay be be used tor any purpose, 
ftoimally, the name yculd identify the teraiinal user, or location if 

shared by users. 

In the case of piintei^ and other non-tec t»*iria i devices, the naae may 
be utilized to ir>rtify the device to host systeirs* The name is 
passed up to the host in the connection procedure, and the host may 
utilize i r. (in conjunction yitfc ether information) as a logical name 
yhich may be allocated to processes ii the system. in this uay, it 
is possible that devices connected via POSEIDON may he used by host 
systems m any way that a directly-coi nee tec device may be used, for 
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exdBiyle as a spooled output device. 

Such uses of the device nase/ hokever, are functions of the 
hctt-based LAT product, and are not explicitly-defined features of 
the PCSEIDtN Terminal Server. 

Other terminal taraireters have been previously discussed. See section 
3.3.2 for the command syntax lor entering terminal paraaeters. 
Discussion of server parameters is providec in section 3.2.5. 



3.1.13 Application Support - 

*11 interactive f t ;odt teni-iral applications supported by the host terminal 
class driver are supported by PCSEICGN. 

Special terminal i«odes, escape sequence recognition and the like are 
performed by the host terminal class criver end the terminal itself. 
POSLIDCN perfcras no special lunctions. 

LAT handles single-character, read-wi th-no-ecno functions, as exhibited 
in such utilities as ETT and CM, but response tiaie may be slightly 
slower than on z directly connected terminal. Section 8.1 gives cetails. 



3.1.14 Security - 

Tn order to provide security from unauthorized users, access to the 
FUSEIDGft functions (including Local &ode) may be password-protected on a 
per-line basis. The Terminal manager »ay specify a LOGON PASSWORD for 
the POSfclDOAi in privileged aode, and then specify which ports require the 
password to be entered* If enabled, the password Bust be entered at the 
lolloping tiffies: 

o Upon IKITI/LIZITIGfl of the PGS&IDCN. 

o ko 1 lowing a LOGGfrf coffiivano in Local Node. 

fchen the terminal is logged off, the user should enter one cr more 
carriage returns to notify the FCSEIDOfc that service is required. If 

LGCOM is enabled a 'Bel* character is output to the terainal, and the 

user has a specified number of attererts (1 - NGLIHIT) to enter the 

password. If the password is entered incorrectly lor the specified 

nu&uei: oi cutisecutiwe -stie«pto, toe tent m el port is uisaoied. it may be 

re-enahle<j only upon a privilecef? cowirantj, cr upon PGS.EIDCN 
initialization. 
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3.1.1b Server initialization - 

The POSfclDON server/ and LAI soityare, may oe initialized in two ways: 
either by electrical poyer-up or by a sottyare INITIALIZE cosiand in 
Privileged Local £ode. The fclloying processes occur upon 
initial ization: 

1 warning messages are sent to the users at one minute intervals 
indicating that the server is cfcout to re-initiaiize. (Initialize 

fVrv 1 „•»'* 
4. J -U X Jf j 

2 All active terminals and virtual circuits are disconnected. 
(Initialize Only). At this point, tne software status, upline and 
dump host fields are initialized. 

j uontioi io tossed to the ^>eii-tei>t aicynostic *hicn tnen executes. 
Upon successful seli-test the front light is illuminated, and 
control is passed to step 4. If self-test detects a fatal error the 
unit yili halt and shouio he referred for service. Upon detection 
ot a soft error, the diagnostics will otinx the front light, then 
pass the error status to the aicrocodt, and continue yith step 4. 

4 The PUStltGN microcode optionally outputs hard*are/ioad status 

uieisSages, then coiittuces to downline load the operational LAI 
software. This operation kill typically take about 10-15 seconds. 
(Details of the loadmy process are yiven m section 3.4.2 and 
Appendix 1). 

b If AUTCBAUL is disablec, go to step 6. If JUTLBAUE is enabled for a 
terminal, input is enabled. *hen tht user enters a carriage return 
(probably iauch later) and the terminal speed is successfully 
determined, the ter&inal initialization logically continues at step 
6. 

6 For all terminals yith LOGON enabled, a BEL character will be output 
to the terminal. This is a proa.pt to enter the LOGON password. 
Once the password is correctly entered, control passes to step 7. 
If LOGON is disabled, control continues at step 7. 

7 All terminals kith a specified Dedicated cr Preferred Host are 
connected to that host. If this fcils, the autoconnect procedure 
will continue to retry this event untii Local £ode is entered by the 
user. II the specified host is c group naise, a connect attempt will 
be made to all hosts in the yrcup (in priority order) tntil a 
connection is successful. 

8 All terminals yith r.c oefau.lt host are put into Local «ode, and tne 
*LLCAL>* protf'pi is 6 ity lay*?«i» 
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3.1.16 Software Support Tools - 

Support services in the foins or an SPh service and telephone hotline will 
be made available to the user ior reporting suspected software errors. 
Maintenance will be performed by a Software Engineering Maintenance Group 
and shipped tc users in autopatch releases (as yith other layered 
products). 

Tools yiii be provided to diagnose arc collect PGSEIDGN software 
problems. A diagnostic online debuggirg tool (00T) will be provided, 
which may be used to obtain detailed information about software crashes. 
The information provided can then be relayed to the Maintenance Group via 
SPS's or telephone hotline. The CD! interface is Gescribed in the 
"PGSF:iDCN Online Debugging Tool Specification". 

There are several bugchecks within the POSEIDON software, which are 
activated upon any iliccicai or "ir-possible" condition that may occur 
yithin the softyare system/ or a fatal hardware error. They are MOT 

activated on any usei eiror/ or illegal message received over the 
fcthernet. If a bugcheck is activated/ t systes crash occurs. Trie 

;. tuijijuii ii t-» jf *- — a o i i i. .*. j, l i :_ .., lg w (_.. i i l v- t, u it L . i to rj ti it. o r jp" i. je a q c i,o j ."i o s t 
SiStem lor later analysis upon system clash. Appendix J gives details on 
the upline uuflsp operation. 

Th<» PSX/V*-"? YL1 utility *ay to* used to u^oate the POSEIDON software on 
the nost. The i&age file contains a s&aii header/ followed by printable 
ASCII text. Software specialists cr customers «iay utilize updates 
provided in Soityare Dispatches or by telephone, when the need exists to 
update tne sortware prior to the shipment of Autopatch. 1'ne image file 
contains a checksum yhich must be correctly updated/ otherwise the 
software will not be runnafcle on the POSEIDON. The EDT utility is 
described in the HSX/VHS documentation sets. 

The maintenance strategy lor correcting errors in the ROM-based microcode 
is a release or a new PCH. No patching facility is provided for the 

ROM-based code. 



3.1.17 Maintenance Functions - 

Tne PUbiilDCN Terminal Server is a fully supported DIGITAL node on the Ml. 
Maintenance tunctions are implemented so that the server operation may oe 
controlled and monitored by the Privileged Local I*ode interface/ without 

active assistance by any host processor. 

The icilo.inq Ctr.ernet itaiatenance luncticns cas descrioea in the 
isoiiitciitii'ice .jj-tutioiis i'lotocci sj. ec ilica t ion) are provided/ and tneir 
particular ii»»p i etventat ion lis outline:'; 

o Loop Server - Tne LAI server ii&plei&en is the Ethernet Loop Server 
functions as foilcys: 
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- Enable Server: This function is implicitly defined as part of 
trse rCbflCCJi initialization procedure. The loop server is 
enabled fol toying a successful initialization and remains enabled 
at all tii&es that trie server is in normal operation. 

- Disable Server; Iris function is implicitly defined as part of 
the i-'CSElDlLN initialization procedure/ and is in effect from the 
start of the diagnostic self-test function until successful 
initialization completion. 

- Enable Assistance/Disable Assistance: These functions are not 

implemented. The loop server never responds to the lookback 
assistance ipuiticast address. 

- Feau Status: This function is ifiip leaden ted as part of the SHOW 

S'kSTEH coaiiiand. The loop server state anu assistance state are 
displayed. 

o Loop requester: dmce PGS£iDUN is designed to oe controlled from its 
Ofcn interface, the following Loop Requester functions are supplied: 

- f, oo r - P ir £"" t * T n *? Terminal **ar??>€r psv test 3 lin$r between the 
P OSfc/IDfjfc and any other specific station, or the loop assistance 
.multicast adctfcSi/ by issuing c *LCCF station* command in 
Privilege Local ^otie. A response is provided within 5 seconds, 
indicating whether tne test was successful. 

-LoopAssisted: The Terminal Manager tsay test a link between the 
PUSLlDGfc and a specific station, using the assistance of a third 
station by issuing a *LCCP station *ITij function ASSIST station* 
command in Privileged Local Fode. k response is provided yithin 
5 seconcs/ indicating yhether the test yas successful. 

-Looopoil: This function is implictiy defined as part of the LOOP 
procedure. Uo user interface is supplied. 

-LoopAbort: This function is iji^licitlv defined as part of the 
LOOP procedure. If a response to a LOCP command is not 
forthcoming within 5 seconds, the loop function is internally 

aborted, ano « failure status is returned to the user. 

o Console Server fruncticrs - Because PCSfclDCN ^oes not support remote 
console carrier functions, this tuinirauia subset of console server 

functions is defined: 

- Identi .ty-*Je i t function - a system-iD message is sent to the 
console server aul least aodress at intervals of 10 minutes plus 
ot minus: e ranoofi) interval up to z Minutes, li seconds. Tne 
systeir-ic" isessace contains all fields required by the HI Node 
architecture specification, and also the iol lowing: 

- 101 Communication Device delated - Diagnostic Status 

- 102 Communication Device filiated ~* ^<LH Version dumber 

- IC3 Communication Device related - ioitware Version dumber 
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- IC4 Communication Device kelated - Server Nureber 

- 105 CoaiEiunication Device helattd - Server Name 

- 106 Cofliffiunication Device delated - Server Location 

- Pead-Identity function - A systeii-ID message is sent to a 
requester node that issues a Read-Identity function to the LAT 

server rode. 

- Keac-counters function - A Couriers asessaqe is sent to a 
requester node that issues a Read-Counters function to the LAT 
server rode* 

In addition to ttnernet maintenance functions/ a ItST lEitMlNAL function 
is provided for users to determine yfether the UART/cable/teraiinal 
sub-systens is functioning correctly. There are three variations of TEST 

i L. i% f I ii H Li a *J L O .1 X O m z> * 

o TfcST TLRrtlfcAL - This rcn-priviiecec coniiiidnd outputs a rotational 
display of ail printable ASCII characters on the requesting 
terminal* The display iray De visually examined for errors. The 
te^t is stepped oy typing any character cueing the test. 



o 



TFST TtiHHl^AL n - This privileged function outputs the ASCII display 
to a specified 1 terfi.-inal (where n is 1-fc). ihe display is visually 
exairirer? fcr orrcrs. The function is stepped b* entering the 
privileged Slut 1£S1 I&kMiiAL n command. 

o TEST TERMINAL n LOGPLACK - This privileged function requires that 
the ter«;inai loopfcack connector is inserted into the specified 
ter&inul port ^rior tc issuing the coamaHQm Tae rotational ASCII 
pattern is yritten to the specified terminal, read back and compared 
for errors. The test is stopped by the STOP TEST TERMINAL n 
coaifiiano, after fchich a message containing the number of errors and 
bytes trans! ered is displayed on the privileged terminal. 

The privileged IfcsT functions ffay not ue applied tc the requesting 

terminal. 



3.1.16 Softy are Reset - 

Since terminal and server parameters »ay be 'permanently* isodified and 
stored in non-volatile Oiencry, a method tc reset the unit to its factory 
(default) settings is required. This is especially useful it the 
Privileged Mode password is forgotten, terminal parameters are set up to 
*bsa* settings, and when ineivioua.1 PCStiDtiy units are transferred into a 
Jifi.ec eiit tiiviiCiiiiieiH or returned iron service. 

This teature is provided c-y a SOFTWARE 1-c.StT button located on the 
r'LiSh !DCN box itself, and is activated try depressing the RF.sET outton 
yhile siaiul tanecusly removing ana insert mc the po*er cora. Smhen tne 
Terminal Hanager activates this control, en iffi&ediate initialize occurs, 
ami 2ii p-er^anert and dynamic parameters are reset to their default 
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values. This control shut-Id OfcL* be activated yhen absolutely required, 
and not as a matter oi course. Normal g oyer tail and INITIALIZE Kill not 
cause the unit to reset to factory settings. 

The FES£T function is i&pleff entec in trie diagnostic self-test code. 



This section presents an overview oi the L/T architecture sufficient to 
illustrate the aieaning of various LAT server parameters. The 
architecture definition is provided in fteierence 6. Appendices €/D and £ 
outline the circuit state processing/ slot state processing and message 

lorjiicsts Ui»eu xn i j u5iiIi>Di*« 



3.2.1 virtual Circuits - 

Covitiunication between PuStTLliN and a host systen* utilizes a synchronous/ 
pcCket-oriented protocol, following the establishment uf a VIRTUAL 
CIRCUIT. t Virtual Circuit associates a PISE1CCN yitfc a .Host system, and 
ail terminals coimect.ee to that host kiii utilize a single circuit. 

When a user requests to CONNECT a terminal to a host/ and no other 
terminals on the PGSLIDCft are co^ffiunicating with that host, a Virtual 

Circuit is initiated between PCSEIDCK and the host. The POSEIDO& sends a 
STAKT MESSAGE, containing server parameters and other intoriiation, to the 
host. Curing this process/ the PGSEILOW circuit is in the START STATE. 

The host examines the Start .Message and decides uhether to accept or 
reject the Circuit Connection. If the host accepts the Circuit 
Connection/ it sends a Start Message back to the PGStlDQfo/ and the 
circuit becomes established. Slot connection (section 3.2.2) is then 

performed. 

PCStlDGfi then transmits fcUN MESSAGES, containing input terminal data, 
control information ana acknowledgements/ to the host at regular 
intervals determined by the CIRCUIT TI>fifc (section 3.2.3). The host 

responds to each message by aise sending a Run message containing output 
terminal data/ control information and acknoyledgeaents. The POSEIDON 
circuit perforins these activities in the Rift state. 

If no data is waiting for transmission for any terminals en the circuit, 
POScIDCf* ft dnsii-iL£> ft U hi y cSokGi.S at ftucli longer intervals de termined oy 
trie KKFl'^ALIV*-' tiiser (section 3.2.4)/ and the circuit enters the WAIT 
state. If data tner becomes available/ the FUN state is re-entered* 

This continues until one oi the stations (host or tQSEIDON) decides to 
terminate the circuit. Normally, this occurs when the last terminal on 
the circuit disconnects/ but reay be initiated fcr a variety of other 
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reasons. The station then sends a STLt* ^ESSAu'fc to the partner, upon 
hbich bcth stations kill terminate the circuit. The circuit will enter 
the HALT state. 

Appendix C sunjsiarizes the processing involved yhen various EVENTS occur 
fchile a circuit is in one ct the above circuit states. 



3 • 2. . i. blOtS "" 

The Virtual Circuit protocol handles the data transport between a 
POStluOn and a host. ?*anagen>ent of incivicuai T£fc£lNAL DATA is performed 
using SLOTS. Run Messages consist of a circuit header, plus zero or a«ore 
slots, etch ilot coj. t es^onciny to Oii« o£ lie connected terminals. 

When a user CGKNFCTS to a host, and following the establishment of a 
virtual circuit/ slot connection takes fcjiace. PGSfclDGN sends a STAkT 

SLOT/ including terminal pcrameters and otter information, to the host. 

during this process, the slot is in the bTJKT STATE. 

The host examines the Start Slot anc cecioes whether to accept or reject 

the 3 lot Connection. It the host accepts the Slot Connection/ it sends a 
^tart Slot ba-cK to the FCS^IDCN/ and the slot beccires established. The 
slot tlitn enters the kbit STATE. 

Terfiiinai input and output, *hich occurs directly to and from slot 
butiers/ is actually transported by the virtual circuit protocol, yith no 

slot st«tt transitions. 

This continues until one of the stations (host or PCSE1DCN) decides to 
terminate the terminal connection, tfouiiaily, this occurs upon a user 
DISCONNECT coofflano, but nay be initiated rcr a variety of otfter reasons. 
The station then sends a STOP SLOT to the partner, upon uhich both 
stations Mill terminate the slot. The Slot feiii tnen enter the HALT 
state. 

Appendix u summarizes the processing involved *hen various EVFNTS occur 

i«hiie a slot is in cr.e of the ahove slot states. 



3.2.3 Circuit Timet - 

The Circuit Timet de lines the interval net keen o^essa^es sent froia the 
-'GfcrJuLrt to a nost system. The circuit ti«i»et fi*ay range from 30 - 200 
ffi 1 iiseconis, ard applies to all circuits en the i-GS£IDC?u 

Under no circumstances will messages he sett aora often than that defined 
by the circuit timer/ even if ircre taan one eiessage is requirea to 
transmit ail yaitmy slots; slots not transmitted in a given message 
will he sent AFTfc'^ the circuit tircer interval in the next message. A 
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round-robin slot selection process bill ensure fair service to all slots. 

Selection of the circuit tiroer value should he co-ordinated between the 
neeos of the terminal users on the PLSfciDCN, and the capabilities of the 
host systems yhich they yill access. A shcrt circuit timer interval will 
potentially iciniirize response tine to the user, but naxiffiize host 
loading, a lone circuit tinier minimizes best loading, but extends user 
response time* 

The default circuit tiiser value of BO sos is recommended for interactive 
terminal use en timesharing systems, host system managers are urged to 
define the jsiniffiuis circuit timer value to be b0 as. This value provides 
fast response (40-50 as average) to teitfiinal users, uhile at the same 
tiire offloading host interrupt processing coirparea to such local 
interfaces such as the DZ11. 

The circuit timer value a; ay be reduced for use on stand-alone, or 

underused, host systerrs tc nuniisize tesporse tiine. Fee systems that are 

very heavily used, a longer circuit timer will increase CiU capacity for 
compute -in tens ive applications. 

A shot* Circuit Tiwei vxlue will increase overhead traffic on the 

Ethernet, since more messages with less data per messaqe will oe 

trans&i tted. Data throughput is constrained by terminal speed, and is 
seremliy not atfectec by cifferent Circuit ?in>er values. 



3.2.4 reer_.8liv-2 Tinker - 

The KEEP_ALlVt TlftES defines the interval between messages on circuits 
where no data is being transported. Ihis parameter is much less critical 
on overall performance than the Circuit Ti&er, but nay have an iagact on 
a heavity-loaced Ethernet. The default value of 30 seconds is 
recommended for timely status information to users in most environments. 

A value of 10 seconds provides fast status information, but yill increase 
Ethernet traffic, especially if many PCSEIDONs are in operation. For 
Ethernets that are near or at maximum capacity, the maximum value of 180 
seconds should be used. 



3.2.b berver Parameters - 

The Ptiwiieueu LoCdl khjc i n t er I d -ct i allows the opacification of various 
server parap^ter^, *rncfr f»ay be used for FCSfrlDGN identification or 
protocol vcji-iaoies. iaraneters at fee tiny tne LAT protocol were discussed 
in ihe previous sections. tther specitian ie parameters include: 

o Server Numbeic - This is a value froe; G-6b535 that may be used in any 
way to ider.tify trie PCSEIOuM unit. I t is suggested that a different 
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number be used for each PG^EIDCN en tie local netwerx. This number 

is passed to hosts in Start Messages* and is included in the System 

Identification message sent upon request from a host systea. The 
default value is zerc. 

o Server Kaae - This 0-16 character ASCII field is used to identify a 
POSEIDON unit by name, or say be used (at the option of the Terminal 
Manager) tc identify type, ownership/ usage cr any other relavent 
meaning. This field is passed tc hosts in Start Messages* and 
Systes Identification messages. The default value is the natue and 
option number cf the FCSEIDCN. 

o Location - This 0-16 character ASCII ireld is used to identify a 
PGSF10UN location, or may be used (at the option of the Terminal 
Manager) fcr any other weaning. This field is passed to hosts in 
Start I*sssages, cnC S^ste^ Identification messages. The default 
value is spaces. 

o Privileged Mode Password - This I~fc character ASCII field is used to 
gain access to the Privilegec Local tfode cotfiaiand set. This value 
sheuic he unique for each PGSEIDCK or group of puStlLGNs managed by 
-i single T **rffin3'i *»<->raqer/ ?nd shouli not r*« onvious. Only 
necessary and knowledgeable users should have access to this 
password, otherwise the performance of the entire network may ne 
compromised. 

The Teriiiinci Manager should reaember the password. It a password is 
forgotten, the POSEIDON unit iray be re-initialized to its factory 
settings using the reset button. The default password of 'SYSTEM* 
will then take effect. The use of the reset Lutton will also 
initialize all terminal and server parameters to their default 
settings. 

o Logon Password - This 1-6 character ASCII field is used to gain 
access to POSEIDON functions if LCGOft is enabled for a terminal. 
The password must oe entered after iUSfilDON initialization or a 

LOGOFF conman-d following output cf a "prompting" Bel character. The 
default LQCQr* password is 'ACCESS*, but should be changed prior to 
normal use. LOGON is enabled by default, and is seen to be 

especially useful for fi ; odea; lines. 

o The SOKTWARF._10 parameter specifies the name of the POSEIDON 
sottware load image tile residing on the host. The following 
filenames are defined, one of which is stored in the ROM area of the 
POSEIDON unit at factury ship (depending on the version of POSEIDON 
orcered) : 

- "t-SotfvlfcNu.aVS - POSFIUCN/b, no fljoaeoi control, Englisa 

- f 50^021-' ^C.^yb 1 - PCSFIDCfs/P, ffodon: controj, English 

- f'30e03£&G.SVS - Reverse PUSEIDGN/8, English 

If the Terminal iianacjei wishes tc ioac an alternate software image 
into the unit, the tile descriptor should be specified prior to 

initialization using the CEFINL SERVER S0FT«ARE_1D command. The 
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tile descriptor is limited to 16 characters, and the following 
ae faults apply: 

- For VfiX/VKS systems: 3YS$3YST£&; filename. SYS 

- ror hSX systems: LB: CI/543riiena0ie. SYS 

o Console - Lne of the eight PLSEIDGN terminals may be designated as a 
CONSOLE terminal/ which may be utilized by ODT and upon systeaj 
crash. II a console terfi*inai is specified/ a system crash will 
output a tfco-line crash message to the console terminal, and display 
the Ethernet address cf the upline duap host (if dumg is enabled). 
The console terminal will also oe used as the OUT interlace (if ODT 
is enabled j. 

uniy uhL terminal atay £e designated as tiie console terminal. The 
default is that tensinal port 1 is th€ Console terminal. 

o buft»p - It the POiEIDLh software detects a fatal logic error, it way 
crash. The Terminal Manager may request that an Upline Duap be 
perfot&eo upon crash. This coa&and erabies the duap process. The 

DDT - The ciagna^tic iiiciocode contain* an Online Leouggmg tool - 
This irsy *:e en at led using the OLT SMAELFD coc&and. 5 CCNSCLE 
teiPinai aiLbt oe defined prior to enacting GLT. Once enaoied/ GOT 
*iii pioiiipt at the CU&5UL& ter&mal upon each of. tne toliouing 
conditions: 

- Upon system crash (after upline dump) 

- Upon a pre-set ODT breakpoint aeing hit 

- Upon a CDT coaasand being entered from privileged wode 

- Upon initialization (alter downline load) 

Heartbeat - All Ethernet tranceivers conforming to the Ethernet Y2.0 
spec iKust enable the 'Heartbeat* collision detect circuitry/ but 
this is ftCI a reguireffent for Ethernet VI. 0. By default/ if absence 
of heartbeat is detected/ the LAT softyare (but NOT Riicrocode) will 
get a transmit eircr en all transmits/ and hence will not function. 
The HEARTBEAT E1SAELED ccsiisiand is provided to alloy POSEIDON usage 
yith transceivers yhich do not have the heartbeat circuitry. If 
heartbeat is disabled, heartbeat errors are ignored and not counted. 



o 



3.3 USHH IiiT£i:FACE 

This section describes the Local Hode interface prcviaed with PCSETDON/ 
inducing all ccasffiands, options and status messages. This command set is 
coRpatiole with tne LAT ia;p lementati or supplied by other DIGITAL Terminal 

Servers. 

If a terminal is specili.ee to oe password-protected by the Terminal 
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Manager, a password n;ust be correctly entered to access POSEIDON 
lunctioris (either host or local aiodes). Ire password must be entered 
upon POSEIDON initialization or following a Local Node LOGOFF command. A 
'Bel* character (Beep) will be output to the terminal after yhich the 
user has a specified number of attempts to enter the password. The 
password may be froB £-16 characters, and consist ci any valid local aiode 
character (see foeioy). The password is not echoed Gn the terminal. 

Local fcode «ay be initiated as the cefault ©ode upon POSEIDON 
initialization/ or in cne cf the folloying hays: 

o The Local Switch character (or break key) is entered by the user 

o If Autobauc is enabled, the user Ray type carriage return, ard Local 
fcode yili be entered. 

o Upon circuit or terminal disconnection for any reason and 

Autcconnect is disabiee. 

In Local ^ode, POSEIDON reads, echoes and processes all input entered at 
the terminal. lo taciiitate usage, (ard lor compatibility with other 
ptcitai fnt«»rf ^r*»5) trp fcllovirq turctiors' "!r" , provided in Local voie: 

o DCLEir Key - Deletes L<n>t Character lypec Leleteu character echoeu 
between sicshes on a hardcopy terminal, eraot,' on <% SOFTCCPY or ANSI 
terminal* 

o COKTHOL/U - Deletes current input line. Echoes as *~U*. 

o CCKTHCL/Fi - Re-echoes entire input lire. cichces as *~R*. 

In addition, output floy control (XCN/XDFF) is fully supported, and a 
function is enabled to terminate terminal tests. 

Command lines up to 132 characters may be entered. All commands should 
be terminated by a carriage return: other coaston line terainators 

(escape/line feed etc) are not supported as line terminators in Local 

.Mode. 

Cc ffliia an ds raay be entered in upper or ioi»er case, and are converted 
internally to upper case* All local acCe exchanges utilize the 7-bit 
ASCTI character set/ and valid corewand characters include: 

A-Z, a-z, G-9, $ (dollar) and _ (underscore) 

Local ^ode commands may be typed ONLY when a prompt is outstanding. 
Local type-ahead is not supported if the proapt has not yet been issued. 

Tne piOftpu ate 3b follows: 

LuCAL> Non-privilegea State 

PHiy_LCCAL> Privileged State 

nil keywords may be abbreviated to 3 or mere characters/ and optional 

Keywords is ay be omitted. For example, the 'DtFlNE SEKVER CIRCUIT TIMER 
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ICC* command may be abbreviated to as little as *DEF CIR 100*. The 

entire keywords 'SKRVtR* ana 'TIHEH' are optional. 

Certain commands aliok the modification of terminal or server parameters* 
Temporary modifications should be issued using the SET cowhand. These 
changes are stored in dynamic memory, take effect iomediateiy and remain 
in effect until changed cr until a PGSEIDUK initialization occurs. 

If a parameter is to oe changed peraianentl y, the DEFINE cowhand should be 
issued. The DEFINE coiiand should be issted GNLY. for permanent changes* 
and not as a regular procedure. DEFIKE co»mands update only the 
permanent iseaory (NVRAP) in the FGSEIOlBi/ and do not affect the current 
state of the server. 

Local ^ode is always entered in the Non-pr ivi ieged state. To enable the 
invileyeo state/ tne lolloping coffi&anc sntulc be issued: 

LGCAL> SET PRIVILEGED 
Passuord> 

The passyoro is not echoed. if another terminal is already privileged/ 

thp *"o.ttovirT^rrcr fp^r ''(jp is ois^ipypo 3 r<? p r i v i 1 en** i 5 not niv**n* 

LOCAL -nn- Terminal n is already priviltged 

It is possiolt: to 'Steal* the privilege from tne other teraimai by 

entering the following coanand: 

LGCAL> SET PRIVILEGED CVERR1LE 

This command shcuid only he entered if the currently privileged terminal 
is out of order. Only one terminal may be privileged at any tine. 

For each couueanci described in the next two sections, a description of the 
command is given, together yith the meanings of any options. Examples 
are given ior non-trivial commands. 

The COPLAND RfcSFGNSfc is tne normal response that would be output upon 
successful completion. It NONE is given, the output of the "LOCAO" 

prompt serves as the coiais^nd response. 

The FRRCR R'ESPGKSh (S) document the possible errcr messages that way 
occur. Any error response results in the non-execution oi the entire 
cottaand: the state of the system after the coma and is the saie as that 
before. 

Certain error responses *«ay occur on any coaiaiand, and are not 
individually uutuiuented. these -ire as .toijows: 

LOCAL -nn- Ccroiaand syntax error 

LUCAL -nn- Privileged coMand or option 

LGCAL -nn- Keyword "XXXXX" net known 



POSEIDDN Softyare Sy ecii ication - CGNPANV CCiNF I LENT I AL Page 35 

USER INTERFACE 



LOCAL -an- Value invalid or out of range, •'value* 1 



3.3.1 Command Set Summary - 

The NQ.N-FR1 V 1LEGED cotta?anLs available in Local &od€ are siiiffiarizcG belcs 

CG&NECT CHCS1J thost-flan el 

{DEFINE |SET> TERMINAL characteristics 

DISCONNECT 

LUGGFF 

h&LF Li.ct»ftNKCT ) DcFiNfc J L ISCbfti* EoT j LLuliFi irtEiU&EJ Stt i SnGM TEST! J 

i> F! T b ST h o s t _ n a a e 

SHGfc CONNECTS 
£> n U s» Is u i> r wJ 
SBtiU TERMINAL 

THe FKivlLi-GLL cooiisanos are suffifliarizec Deic*: 

CUMECT TERMINAL ti|2|...|d> LHGST host.naaeJ 

<DEF1U£|SET> {LOGON J PR I V ILEGEDl PASS«CRL 

{D£.i , 'l.Miii SET> SEPViLK characteristics 

tbtY ifth | aLT> TckftlftAL ili2i***|b> char acter ru tics 

DISCCMFCT TERMINAL tl|2i...iS> 

h&LP CtDEFINtllNlTIALIZFILOCFISLTlSTDi-i ZLRUJl 

INITIALIZE L ABORT 3 

CDELAV ffiinutesl 

CCISA8LE3 

CTEST options J 
LOOP STATION stationl_id 

CliITH {TRAfcSMTlRECEIVEiEULL} ASSIST STATION station2_id3 
JDT 

StiuU ALL connects 
smy, counters 

SHGW JLL HOSTS 

SHGii SLBmER 

SHO* TERMINAL n 

STOP TEST TERMINAL i 1 ! 2 J . . . i 6 J ALL> 

TEST TKPhlfcAL L 1 1 ] 2 | . . . I 6 I ALL> 3 tMCT* rnl lCGLKT nnl LLGCFBACK1 

ZERU COUNTERS 



POSEIDON Software hyecii ication - CG«PAN\ CCNMLENT1AL Page 36 

nod- privileged C omm a r; d s 

3.3.2 !i.oii-4>r iv iieged CojE&ands - 

u CONNECT LHCS13 Chost.naflie J 
SET HOST Chost.namej 

The CONNECT conaano logically connects a terminal to the specified 
host system* The .host name is the 1-16 character rase of the nost 
system, optionally followed fay a douD le-coion. SET HOST is provided 
for DECnet/VAX compatibility* 

If no host name is specified, an attenpt to connect to the Preferred 
Host (if any) is made. 

Examples: 

LQCAL> CONNECT 

LGCAL> SET HOST bEiiGIL:: 

Command Response: 

LOCM -nn- ronpfftion t<"» hort X'>XX"X y «r> t a"M i ^n^d 

Lnoi l.esncnses: 

LUuAL -mi- .NOol XAAXAX not khOXu 

LOCAL -nn- Host XXXXXX not available (code xx) 

LCCAL -nn- Connection tilieady a^tdLlished 

LOCAL -nn- Connection to host XXXXXX not established 
host rejects connection (code xx) 

LOCAL -nn- Connection to host XXXXXX not established 
Host does not lespone to connect request 

LOCAL -nn- Continuing attempts to connect to host XXXXXX 

LOCAL -nn- Preferred host not defined 



o DISCONNECT 

The DISCONNECT command logically disconnects the terminal from tne 
connected nost system/ or cancels connect attempts initiated by 

<iu locojiuec t. FcIIuteirtf the disconnection. Local ^o<ie is entered ana 
the *LG€*L>* prompt is issued. 

Coicftanc Response: 

LOCAL -nn- Disconnected from nost XXXXXX 
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U on-pr iv 1 1 e g e d C ohijd and s 

trror Kespcnse: 

LOCAL -nn- No connection established or requested 



o HELP L <CG NN EC'fj Dfc FINE J DISCONNECT J LOGO *f ' J h£SUM| SLT I SHQ« i TEST13 

The riELP ccairoand displays a list ci commands available in Local 
Mode. Il a keyword is supplied, the coaiand provides help on the 
command specified. 

hx ample* 

L,Ui*iiL,y utLlt'C L U ft Li fu i, I 

Command Response; 

A help display as shoun in Appendix G 

**' r r o r ^'sncns« * 

LOCAL -nn- Kt:y*Gi:d "XXXXii" nut known 

toiio*ed by the HELP display snc^n in Appendix G.l 



o LOGOFF 

This command effectively terminates the user's entire terminal 
session. If a host is connected, a DISCONNECT is activated* The 
LOCAL> prompt is NCT re-issued, end any modem connection is 
terminated* To re-use the port, the LOGON PASSWORD (it enabled) 
must .be entered. If LOGON is not enabled, local mode may be 
regained by entering a carriage return* Following a successful 
LOGON, dynamic terminal parameters are reset to the permanent values 
stored in Ky_RJHL 

Command Response: 

LOCAL -nn- Lodged oft terminal i; 



u RESUME 

This coirnard is effective eftec Local teooe has been enteied during a 
ternindl/nost session oy aeans ol the Local Switch character (or 
break key), and is used to exit Local node and resume Host Mode. 
k€SUH"F alto restarts autcccrrect if a requested connection was not 
successfully established prior to entering Local !*ode. 
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Non-pr ivileged Cofn&ands 

CoQin?ard K espouse: 

LOCAL -nil- Connection to host XXXXXX resumed - OR - 

LOCAL -nn- Continuing attempts to connect to host XXXXXX 

Lrror Response: 

LOCAL -nn- No connection estaolished or requested 



o SET TE&WINAL characteristics 
DEFINE TERMINAL characteristics 

The a*ET TERMINAL command enables a terminal user to modify dynamic 
terminal parameters. The DEFINE TERMINAL co&mand enables a user to 
iuoeiiy permanent terminal paraflsetei^. Terminal parameters are 
discussed in section 3.1.12. One or lore parameters usay be entered 
pet comfiianc, separated oy a space, cojena or ooth. 

Tne characteristics may consist of one ot the following: 

AUIGLGKKECI tEAUfeLfcDti)i£ABLr,D> 
CHAHALlty- Silt C 7 I 8 > 
PREFERRED hOST ihos t.naffe J NONE! 
I&PUT tLLk CCNTRCL iENA£LEDf L IS JBLEQ1 
INPUT SPEED fcits_per_second 
LOCSL CSfclTCHJ ChAaACTEh tcharlBREAKi 
LOSS EtfCTIFICATIOIU {ENABLED! DISABLED! 
LUIPIT FLO« CONTROL iEH ABLEDJ D 1S*BLED> 
OUTPUT SfrEED bits_per_s€Cond 
PAKITV IGDD|EV£N!NOIIE> 
iPEED ni ts-per-seccna 
STOP BITS UJ2> 
TYPE £HARDCOPVISQFTCOPY|ANSI> 
Ex amp It: 

LHCAL> SET TEPMIJiAL AUTGCOfiMECT CU3LED, PREFERRED JiGST S^AUG 

Corrroand Response: 

None 



o SHOW CONNECTS 

The sHuv CLNftELTS comirand displays i r.f oimaticn about the current 
connection status of trie terminal* 

Coiiitisand Response: 
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hon-privilegec Coraoiands 

The display as shown in Appendix t • i is output. 

o SHGS HOSTS Chost_na& i e3 

The SHQVi HCSTS command displays information about host systems 
accessible to the teiainal user. The coamand cones in two flavors: 

- It 'SflOfc HOSTS" is typed/ a one- line-per-host display of all 
hosts accessible to the user is output* The information 
contains host na»e, status and abbreviated ID message. 

- If "ShON HOST host^naffie* is typed/ wore detailed information 
about the specified host, including counters/ will be 
disp layed. 

Coffiraand Response: 

SHCN HCSTS display examples are shown in Appendix F.2 and r.3. 

Error response: 

LCCAL -nn- Host JUXXXX net known 



o SBQti TERMINAL 

The Siiu» T&t-tftlft At. coniyand display s tne dynamic and permanent 
terminal paiameters and current cennection status for the user's 
terminal. 

Example; 

LCCAL> SHOU TFRVINAL 
Coj&mand Response: 

k oULm TfcftttlNAL display example is shown m Appendix f.4 



o TEST TERMINAL LW10TH nnJ CCOUNT nnJ 

This coeusard instructs PDSilCGfc to test the user's terminal. A 

rotating ASCII pattern, containing lines oi the specmed ^IDTu, are 
output to tht taiiuinal* Eidth as ay v^iy fcoa 1 to 255 characters. 
If no width is given, a detail It of 70 is used. 

The uOUNT parameter defines how if any lines are output. It not 
specified/ the count ail I be indefinite/ and the test nay be 
terminated by entering any character (ci fcfcEliO on the terminal, or 
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Non-pr iv ileged Coamiands 

enteiing a STGr TEST TER^l&AL coaaiand irora the Privileged Local 

M o d e • 

Example: 

L0CAl> TEST TLft^INAL V1DTH 20 Clu^T 48 
Coajsard Response; 

I ** v ■*> \ J '/"•/ wiiJ 

§"|f$^r'()*+ J ,~./01234 
»W()*+ / -../012345 
#$**"()*+/-. /0223456 (user types on terminal) 



3.3.3 Privileged Coou&anGS - 

c CONNECT TERMINAL < 1 1 2 I . . . I £*'> CHCHT tiO£t_naireJ 

ihjLS command implements the sarse lurction as the non-privileged 
CGfcKECT command, except that a specific user terminal is specified. 
This cc8s&ard is provided in order to connect devices yhich do not 
have a keyboard (stch as an output-only printer), and ftDT to 
override the user's connection at the terminal, hence, the 
specified terminal irust of the type "0THEF% or have a DEDICATED 
hOST speciiied, and not support Local Mode. 

If the hG£T name is not supplied/ the specified terminal is 
connected to its dedicated or preferred host (if any). 

Ex ample; 

ocjy irr*f) rr%iKx.ri TtpMiiiisr i ire? c p c p j r • » 

Cowraand Response: 

LOCAL -nn- Connection to host XXXXXX established 
fcrror Responses: 

LOCAL -nii- nost a'Kaaaa not knotor- 

LCLAL -nr.- Lost XXXXXX not available (cede xx) 

LOCAL -an- Connection already established 

LOCAL -nr- Correction to host XXXXXX not established 
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Host rejects connection (code xx) 
LCCAL -mi- Specified terminal supports local mode 
LOCAL -nti- ^referred host not defined 



o DEFINE {LCGQMjPRl¥lL£GfcD> PASSiGRD 
SET CLiiGGNJPRIVILEGED> PASSWORD 

This coiBfiiaiid changes the LCGGN or PRIVILEGED password lor access to 
the reiavent PGSfelDCfc functions, SET PASSWORD changes the dynamic 

password; DEFINE 1'ASSfeCRD modifies the permanent password. 

ishen either command is entered/ two password proapts are issued. 
The same 1-6 character alphanumeric password should be typed in 
response to each prompt. Since the password is not echoed on the 
terminal, the dual entry minimizes the probability of a spelling 
error m the password. Example: 

PRlV_'LuCAL> LEFINE LOGON PASSWORD 

Password} ; Type password 

i-'ass¥or^> ; repeat password 

CQ&iiiCiVlii K€ispuriSt;« 

U one 

It is important that any permanent change to the PRIVILEGED password 
be reffiembered. 



DEFINE SERVER characteristics 
SET SERVER characteristics 

The DEFINE SERVED characteristics updates permanent server 
parameters. The SET SERVER characteristics updates dynamic server 
parameters. DtFltot SERVER coafcands way be entered at any tiroe, and 
take effect upon the next initialization. SET SERVER commands may 
be entered only when no circuits are active/ preferably with user 
terminals disabled. One or acre parameters may be entered per 
command* section 3.2.5 provides a description of server parameters. 
The list ot settable parameters are: 

CTRCuIT II*?n «hi 11 iseconos 

CPNStLJ* <niNi-NE> 

L=uMi- <t NAt'LEL|DISABLED> 

iu:artf>f;,4t cenabledidisapleio 

KEEP ALIVE TIfcER seconds 
LGCAilGN M iocation_te.xt" 
NAME M naaie text" 
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ftUKHER inteyei 

UDT l£NA£LEQiDISABLED> 

SGFTfcARE_IL iilenaffie 

CofEffdDd Response: 

None 
Error Responses 

LOCAL -nn- Parameter cannot be »odifiec, connection established 

LLCAL -nn- Paiaireter cannot be cynainically modified 

LOCAL -nn- Console terminal not defined 

Note that the keyuoid SELVES aiay be oaitted from any SET SEHVlR or 
UEMNF SERVEK' contsand. 



o DEFINF TFRMKAL <1|^|.-.fP> rh?r?r t er is t ir? 
SET TERMINAL <U2|„..|b> characteristics 

Tlhis cofmard alleys the privileged user to define or set any 
terminal's parameters* The terminal &ust ue idle ana not connected 
to a host fchen this cosniand is given. The characteristics are the 
sane as fcr the non-privileged DEF WE/SET TERMINAL, except that the 
following additional characteristics nay be set: 

AUTOBJUC tENABLEDfCISABL£D> 

DEDICATED HOST (host.naae \ flQNE> 

ACCESS <£NABLED|LIS/»LL£L1 COLES 10 1 1 1 . .. 1 127 I ALL> 

LQGU^ {ENABLED* DISABLED} tiLIUlT nn| &CJL1MIT )3 

MODEM <IBSEMI|PRESfcHI> 

hkkt "name^text" 

1YPE <BARDCCPY|SCFTCOPV JANSI IGTBER* 

{READ.HRITEJREAD.OhL¥i^i<IT£_a^L^> 

see the ron-£rivilec,ed DFFINE/SET TFkHIKAL cocaand for aiore 
irioimatior. 

PRltf.LLCAL> SET TEneU&AL 1 LOGO ft ENABLED LINIT 10 
COHtfnanfl Response: 

trior Reiipcnje: 

LOCAL -nn- Paraaeter cannot he cyna&icaJiy modified 
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Privileged Coiciyands 

o DISCONNECT TERMINAL il t 2| ..• | S> 

This conffldrd disconnects a specified terminal from the host system 
that it ±h currently connected to. It is iunctionally similar to 
the non-privileged DISCONNECT command. The conisand aay only be 
issued tc a terminal of type "LTdER", or one with a DEDICATED HOST 
specified. 

Ex a asp let 

PK'IV\_LCCAL> DISCONNECT TERMINAL 4 

Coffifnand Response: 

None 
biror Kesponsei 

lUCAL -nn~ Ho connection established 

LOCAL -nn- Specmed terminal supports local iiode 



o HELP L ibLt iNfci INiTiAL.U£iLCuri^Ll|SXUjriZLKO> J 

This cowiard is functionally similar tc the non-privileged HELP 
command, except that information about privileged commands is 
available, as *eil as th non-^r iv ileg td coffittands. See Appendix G 
for details. 



o INITIALIZE CDELAV minutes! EDISAfcLEJ LIEST options! CASGKTJ 

The INITIALIZE command instructs PQ3EIDGN to perform an orderly 
shutdown of normal operations, execute the diagnostic self-test, and 
re-initialize. Section 3.1.15 describes initialization. 

Ii tne 'D&.LAV minutes * option is yiven, the initialization will take 
place ir the specified number cf trirutes. £t one minute intervals 
prior to initialization, warning iressages are printed to all 
terminals alerting tne users that the local systeai yill be 
re- initializing. The delay variable say vary between and 255 
minutes, ar.ci the default is 5 ic invites if no 'DELAY* option is given. 
To get an immediate initialization, 'LELAy. 0* should be entered. 

If the *T p S? n~ticr.r* keyword is given, non-standard diagnostic 
testo will be performed. The options will be delinea at a later 
date. The default is the stanoaid seii-test diagnostic. 

3.3.3.99.1 define Test Options for initialize cottmand. 
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if the DiSicLE keyword is given, the newly-initialized POSEIDON will 
not aliou autoconnect or any Local Mode command except 'SET 
PSlVILfcGEC*. Once a terminal is trivileged, all commands are 
honorec* To re-enable the server tor normal operations, another 
INITIALIZE command, excluding the DISABLE keyword, must be entered. 
This option allows tor maintenance rune t ions to oe carried out on 
the fOSElDCN without interference froit other users. 



The ABORT qualifier has the effect of aborting a 

previously-requested initialization, which has not yet taken effect. 

Regaining warning messages yill he cancelled, and the server will 
continue tc operate normally* 



Examples: 



i W ^.uL biuJ AiMJ.ll 



ALI2 



£.LaV 



PRiy i-CCftL> INITIALIZE DELAY LISAfaLE 



Cctrmard Response (all terminals): 



t.nc *i ?. -flu— ^A^NTNr; 
LOCH -nn- ^AbNlhQ 



Local ?Pc rervic*? ending in nnn minute (s ) 
Local area service ending in nnn ininute(s) 



lUCAL -nil- WA»MNG — Local area service ending in 1 isinute(s) 

LOCAL -nr- Locai area service ere 



o LOOP STATION station_id 

This command instructs the POSEIDON tc attempt to communicate with 
the specified Ethernet station using the Ethernet maintenance 
protocol heply function* This ceisniand tests the physical 
connectivity uetyeen stations, and the station need not be a LAT 
host system, a message indicates it the test is successful or not. 

Ex ansp le : 

PMV_LOC£L> LOOP STATTON 1C-1F-23-43-1 A-00 
Coniisand Response: 

LOCAL -nn- Loop test successful 

lOCAL -nn- Loor test failure 



POSEIDON Soitware Specification - COfcPANV CCMFI LENTIAL Page 45 

Privileged Commands 

u LOGP STA1IGN stotiuni-id ilTH {TKAfcSM 1I| k£C£lVE|FULL> ASSIST STATION 
station 2- ic 

This coicaand instructs the server to attempt to coffitaunicate s*ith the 
specified station! tsing the Ethernet Maintenance protocol Foryard 
Message anc Repi> rurctions, with assistance iron? station2. The 
message ^atfts are as iollous: 

Transmit Assist: PGSfe IDCfc-stati cn2-stationl-PQSEIDCN 

Full Assist: PGSEID0N-station2-stationl-station2-P0St;lD0N 

This coward tests the physical connectivity between stations, and 

the stations need not oe LAT host systems. 

CX 8'iuy J xi I 

PkIV_LuCAL> LGGF STATION U-l i-- i3-43-l A-00 *i?h FULL 

ASilbT STATIuN 10-2 J-19-G0-13-0G 

Coniisand Response: 

LCCAL -nn- Loop test successful 

LOCAL -nn- Loot* test iailuie 



o ODT 



The UDT command is utilized to bteaR into GOT during operations. 
For this to oe eiiective Loth a CONSOLE terminal ffius t be defineo/ 
and ODT previously enabled using SiiT/LEFIME server commands. Upon 
enteiing tne OCT co^and/ all epetatiens will immediately cease/ and 
the GOT prompt will be issued at the console terminal. Any terminal 
or Ethernet traffic arriving during the GOT session Bay be lost. 

Command Response: 

None (at the requesting ter&inai, if not the console) 

* (at the console terminal) 

C r i o r Responses 

LLL/;L -nn- Cii'l not enabled 
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o SHCW ALL CCNNECTS 

This cofljtfiaiid is similar to the non-pr ivilegeo SHOW CONNECTS cosyuand, 
except that the connection status tor ail terminals is displayed. 

An example is shown ir Appendix £. 5. 



o StiOW COUNTERS 

The SHG»f CLUSTERS cofiueand displays Ethernet counters and Server 
(LA?) counters. 

ftxamp 1e : 



Command [-.esponse; 

Appendix F.6 provides an example of the StiGy COUNTERS display 



o SHCW JLL HCSfS 

Tat SHu* ALL huS'lL coifcfliariti enables to fc privileged user to vie* all 
nost systems that are stored in the host data base, instead of only 
those hosts which are accessible ft am the terminal. The display is 

similar to the non-piiviie^ed SHC* liQSTS display. 



o SHOW SEfiVEF 

The SHCiRi S£«VE« coflnisnc displays server parameters and hardware 

status. 

Example: 

PfrIV_LCCAL> SflLfc SfcRVEfc 
Command Response: 

Appendix F.y provides an example of the StiCb SERVE* display. 



o SHLfc TERMINAL n 

This coinn-.ar-d displays terminal chai ac tenstics 01 any terminal *n* 
(1-8) in the san-e xorrcat as the non-privileged SHCW TERMINAL 

COH'PigPd. 
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Privileged Commands 

o STOP TEST TERMINAL <i|2i*..|B> 

This corcaiand terminates any test activity generated by the TEST 
ThhiUNAL n coma and* It the test involved the LGGPbACK function, the 
results of the test is printed out on the privileged terminal* 

LXaffip 1 eS 

PRIV_LCCAL> STOP TEST TEfcHlNAL 2 
Cowhand Response: 

LOCAL -nn~ Test complete, xxxxxxx bytes written, xx error(s) detected 
Error Response: 

LOCAL -nn- Terminal n not under test 



TEST TEFFIKJL C 1 1 T I . - . j --^ [HC?'! r.:. 1 LC°l l 'T rn.3 ZLZZVICTI 

This command conducts trie saEie terminal test as the non-privileged 
i'E^T 1'EhMN.aL cofl-iiidi d# except th <? t aiy terminal i«.ay oe tested. The 
teiwinai nust be ir? Lccal ^ode for tn is function to kork. 

If tne LOOKBACK keyword is given, the external terminal loopback 
connector must be inserted into the specified terminal port* In 
this case, the test pattern is fciitter to the terminal port, then 
read uack and the data compared lor correctness* mhen the test is 
terminated, a message indicating the number ot errors, and nuasber of 
bytes transferrer, is oispiayed en the privileged terminal* 

To terminate the test the STOP TEST TERMINAL command should be used. 

E.xaiaple : 

PF.IV_LGCALJ> TEST TtRfclNAL 5 ttlDTH 132 LGOPiiACK 
CoaKand Response: 



o ZEKC COUNTERS 

TMs cofflfrsnd zeros all dynamic istnernet ano server counters 
contained within PGSEILC&* The seconcs-since-zeroed counter is also 
reset* ihis command ccas NOT zero the up tiff e or software status 
.fields displayed in ShCfc SERVES. These are zeroed by an INITIALIZE 

coflijidna instead. 
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CoEinenc Hes^onsei 
None 



3,3.4 Status Ard Error Messages - 

The following is a lull list of status and error aessages, uhich should 
be self-explanatory hasec on previous cescripticns and examples. For 
those rcessa^es *here "(code x.x)" is output/ the codes are explained. 

All Messages have an associated MESSAGE COCF/ to facilitate use in 

ncn-Ciiilioh ^ptakiny countries together with na tive-ianyua^e 
documentation. \t this tiase the error codes have not been defined, but 
are shown as 'nr* in the leessaye. 

3.3.4.99,1 Status Message Codes to "be defined. 

Initialization Messages <**i^h *«e'0: 

l'/'CaL -nn- Local irea ssrvice start/ POShlCCN Vx.y (caa.bbb) 
y a e i e i 

x = External Major version number 
y - External Mnor version number 

c = internal Version status Code as follows: 

*¥* Release version 

*Z* Field test version 

*H* iiase Level version 

*X' Development version 
aa = Internal software major version number (1-2 digits) 
deb = Internal soltyare revision level (1-3 digits) 

An example fcouid be POStlDCN Vl-0 (¥04-000) 

LOCAL -nn- Internal isefccry error in server parameters - 
Svstes defaults in effect 

uOCAL -Jui- Internal memory error in terminal pardt«eters - 
•rysteff defaults in effect 

LOCAL -nn- This terminal nsay not functicn correctly - 
Continuing operations 
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Logon Messages; 



LOCAL -no- Local area service disabled 



LOCAL -nn- fcrterirg Local Mode or, terEirai r 



Connection States .Messages 



LOCAL -nn- Connection to host XXXXXX established 



LCC£L -r, 



Ciaconntcteu from host XXXXXX 



.GCAL -nn- Connection to host XXXXXX not established 
Host rejects connection (code xx) 



Code 


1 


- 


U 


Cede 


Z2 


- 


I 


Code 


3 


- 


I 


Code 


o 4 


- 


1 


C c d e 


Ub 


- 


F 


Code 


09 


- 


fc 


Code 


10 


- 


o 

i. 


**# L# ci L. 


11 


- 




Code 


12 


- 


H 


Cede 


13 


- 


F 


Cede 


14 


- 





see requested disconnection 

nvalid Message Foiiaat Received 
nvalid Local Circi.it Identification 
nvaiid ^euiote Circuit Identification 
nviieged disconnect or PCSEiOQft initialize 
;o host resources 
CEEIDGfc Circuit Timer too short 
ser requested shutdown 
lost system shutdofen in progress 
atal Communications Error (Invalid Slot) 
ilegal Service Class 



LOCAL -nn- Connection to host XXXXXX not established 

Host does not respond tc conrect request 



LOCAL -nn- 



Connection to host XXXXXX not established 
Ccisrounicatior error with host 



LOCAL -nn- Connection tc host XXXXXX teiainated 
liost disconnects circuit (coce >x) 



Code 01 - User requested disconnection 

Coufc 2 - Involio 1 Message botitidt deceived 

Cde 3 - Trveiid Local Circuit Identification 

Cede 04 - Invalid Kemote Circuit Identification 

Cuds 05 - Privilegea disconnect or POSEIDON initialize 

Cede 07 - TiB-e lisit expired (.from rest) 

Cede 08 - *etransn;it liait reached (frorc host) 

Code 09 - wo host resources 
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Cede 10 - PLSblDCN Circuit Tiaer too short 

Code 11 - User reguesteo snutaoun 

Code 12 - Host system shutdown in progress 

Cede 13 - hctbi CoviRunicatiors Error (Invalid Slot) 

Code 14 - Illegal Service CI ess 

Code 15 - Terminal not authorized to access host 

LOCAL -nn- Connection to host XXXXXX terminated 
CoBiiiiunica tior, error *itr; host 

LOCAL -nn- Specified terminal supports local fflode 

LUCAL -on- Connection alieady estaoiisneo 

LOCAL -nn- Continuing attempts to connect to host XXXXXX 

Connection Status Messages (no -:ctior t :?*?-? r): 

L = ;CAL -nn- Ccrafljunicat i crs *ith host XXXXXX lost 

Continuing attempts to re-establish communication 

LOCAL -nn- Ccffiaunicaticrs kith host XXXXXX re-established 

LOCAL -nn- Logged off terminal n 
User Error Messages (Conjnand is not processed): 

LOCAL -nn- Cowhand syntax error 

LLCAL -nn- privileged ccaiiiiand or option 

LOCAL -nn- Keyword "A XXX" not kno*n 

LOCAL -nn- Value invalid or out of range, "value" 

LOCAL -nn- Host XXxXXX not known 

LOCAL -nn- ^c connection established or requested 
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LOCAL -nn- Terminal n is already privileged 
LOCAL -nn- ?ern<. inal n not under test 

LOCAL -nn- Host is not available (code xx) 

Cede 00 - Host status unRnutei 
Code 03 - .Host is unavailable 
Code 06 - Best is unavailable (Backed tor delete) 

LOCAL -nn- Preferred host not defined 

LOCAL -nn- parameter cannot ne modified, connection established 

LOCAL -nn- Parameter cannot be dynamically modilied 

LOCAL -nn- 01? not enables 

Test Related Messages: 

LOCAL -nn- Test coapiete xxxxx bytes written^ xx eircr(s) detected 
LOCAL -nn- LcoiJ test successful 

LOCAL -nn- Lccp test failure 

Pre-initialization Messages (with ILL): 

LOCAL -nn- *AHiiIMG — Local area service ending in UhU iainutes 
Lf-CAL -nn- Local aiea service enc 
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3.4 KICPUCUDL DESCRIPTION 

The POSEIDON cayab ilities described in the previous sections utilize 
software that is dcyrlire-ioaded following successful initialization. 
This section descrices the ROM-based microcode which handles the 
downline-load operation end required lew-level Ethernet maintenance 
services. 



3.4.1 Status Reporting functions - 

Upon each POSfcTOHN initialization, power-tail or fatal error, the 

RCW-bastd uiayrootic sell-test executes tc verify the Poseidon hardyare. 

There are three basic results of the self- test, which are reflected in 
the state of the rOSEIDON front liyht as rclleas: 

o Unit is fully operational (light constantly on) 
o Unit is partially operational (light clinking) 
o Unit is not operational < 1 i o h t off) 

The diagnostic status is reflected in the light approximately ten seconds 
following the initialization. It the light regains off, the unit 
requires oervict and will not tunction in ciiy way. 

The POSEIDON microcode jrcvides a Eecharism fcr reporting non-fatal 
errors and downline load status to the user following initialization. 

This is done by entering one or t*o carriage returns on one of the 
terminals connected tc the unit, ana observing the tRessage(s) displayed. 

The first message identities the £GSEIDatf end its Ethernet address: 

LOCAL -nn- Initializing POSEIDON 'Ether r:et_address* 

It the trout iLStlDON light is blinking, the following message ail'l 

appear: 

LCCAL -r.n- EARNING -- Ken-fatal hardware error detected 

Server status xxxx, terminal status mm nnn nnn nnn nnn nnn nnn nnn 

where 

xxxx is a uitflsat code indicating a ncn-iatai error condition 

which affects the server as a whole. Fach *x* a s ay be a 
zero or one, a cne aieaning that the condition is true. 

clou, 'tfcii, to t i c; li t the cooes u t e ; 

o ChecKsuir etrcr in server paraieters, using system 
rteicul ts 

o til ^ott hardware error, ex terra! lookback test failed 
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o til Port hardware error, no neartoeat detected 

checksum error in diagnostics parameters 

nnn is a oit&sy cooe indicating a non-fatal error condition 
which affects a particular terminal. Each *n* «ay be a 
zero or one, a cue meaning that the condition is true. 
tach group of 'nnn* represents the status tor terainals 

1 to 8 froa left to right, feitnin each group, the codes 
are (from left to right): 

o Checksum error in terminal parameters/ using system 
defaults 

o naid eaoi on terminal port/ tort disabled 

o Dynamic en oi an terminal port/ port enabled 

The microcode will similarly provide status information as to the 

:r?rr n r:. el rro do* ~.M:v: to.. ' t Toc:. "'li.. The folio-f^ - ti uact af 
messages kill appear in n rcrirai load procedure: 

LHCAL -nii- -oiling lor iitoge Ho^jd 

LOCAL -nn- Loaning trow ho;>t *£ tnerne t_audr ess * 

Following a successful load, the operation*! LAT software gains control 
and starts teti«ina! server operation. If an error occurs in the load 

procedure the iciio*ing message occurs* 

LOCAL -nn- Load failure, protocol error -QR- 
LGCAL -nn- Load failure/ ti&eout 
LOCAL -nn- Waiting for image ioao 

ii no host volunteers to load the unit/ the "waiting for iraage load* 

message will be repeated at intervals oi 30 seconds, and the unit will 

attempt to load indefinitely. Reloads are also attempted if downline 
load fails. 

At any time following self-test execution, and prior to the completion of 
downline loading/ a user way request r c-initializatior, of the unit by 
typing in a specific control code (ccntroi/P hex 10). however, 
re-initiaiizati.cn takes effect UJSL* upen downline load failure. This 
prevents unauthorized users from re-mi tiaiizing the unit during the 
normal Downline load procedure. It contcol/P is typed/ and downline load 
is successful, re-iuit iaiiza tion will not occur, out way thereatter be 
requested using the ftivnecea Local ^cde interlace. 

Trie Control /P asust up. typeo after the initial carriage return for correct 
interpretation. This function is nicviced a^ a weans to re-ini tiaiize 
the unit in the absence ol software without removing tne power cord. 
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3.3.2 Downline Load Function - 

The POSEIDON microcode contains a tertiary loader program to load the 
entire operational soltyare iiuaye into memory. The load procedure 
utilizes the standard Maintenance Operatiors protocol and requires that 
there be at least QUE active Phase IV DLCnet node on the Ethernet* 

The PUSEIDGft requests a specific load image file from the host/ its naae 
being stored in permanent roeirory. This isaage filename defaults to 
FS0801E8G«S¥S/ fcu t lay be changed by the terminal manager using the 
'DEFINE SERVER SQFTfcASE_ID* command in Privileged local a?ode* This 
feature facilitates the ircplemetation cf foreign language support* 
Details o.£ the GOi»nlirie-load function are provided in Appendix I. 

If the diagnostic status reports an external loopback error condition, 
the downline load will not be attempted. The following message Mill 
appear instead: 

LOCAL -mi- linage icao net attempted, network co»«unication failure 

Thii, message inoic-jtes trial the ^L3£ILUh n£3 no Ethernet access, ana may 
he caused by cab lino oi transreiver r ro r t*?fr<*. fcliokir^ this ressagc/ 
control/P may he entered to r e-i n it ia iize the unit, and cause a 

subsequent downline ioau. 



3*4.3 Upline uLmy Function - 

The POSEIDON a«ay be requested to upline ouirp its memory to a host system 
upon a system crash. This may be specified using the SET SERVER DUMP 
EhALLLD command in privileged aiode. kit en enabled, and a system crash 
occurs (except one caused by the katchcog timer), the POSEIDON memory 
will he dumped to a dump volunteer host- The following messages will he 
printed out on the designated CONSOLE terminal (if any): 

LCC£L -nr- Fatal Bugcheck at xxxxxx, St^xxxxxx, SR=xxxx, TP=xxx 
LOCAL -nn- Waiting for ijsage duiip 

LOCAL -nn- Dumping to host 'Ethernet address* 

The Fatal Fuqcheck message displays the address of the instruction 

causing the ciasn, trie stacR pointer (SP) and Status register (SR) at 

that time, and the crash type (IP). The crash types are defined within 
the listings cf the code* 
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3.4-4 maintenance functions - 

The FQSklDG^ reicrocace *ill support tile lolloping loy-ievel maintenance 

functions/ which are initiated iron* a host systesi; 

o For yard message 

o Reply 

o Identity-self function 

o Read-identity functicr 

These functions satisfy the fliiniiuufii network managesent requirements for a 

DIGITAL node on the Ethernet/ and are described in section 3.1.17. Note 
that the POSEIOtM-initiated hoop requester and kead-counter functions are 
not supported ry the ifiicrccoce/ but are supported by the downline-loaded 

operational softyare. 



3.4.5 Online Debugging Tool (QLT) - 
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help diagnose any system rroDleics that nay occur during POSEIDON 
operation. This tool is a runcticnai sunset or the iAS/nttX-llfe OUT, and 
it described i\ thtr "fCSiilDGN Pi agues l ics rniind Debugging Tool" 
specification. ^h* 1 HIT is designed to be used by Softyare Services/ 
Field Service or other specialists hi th knowledge of the software 
residmy in the PCSnICCfc. 

It is muT expected that Oul will utiiizea by customers/ and its operation 
(ana the privileged uscoe ccmaiands that invoke it) is not descibed in the 
normal POSEIDON documentation set. It is/ hoyever/ described in the 
POSiilDGN technical manual* 

fur therefore/ it is expected that the CDT function will only be used uhen 
tracking down probleffls, and will not be enabled in the noraal mode of 
operations. The socialist trust enter the following coajuands from 
privileged local rode before GOT can be utilized: 

PRIV LUCAL> SET 6tky&ti CuhSQLE n 
PRIV_LGCAh> S*1 SERVER CDT ENABLED 

*here ; 

n is a POSfclDOh terfiiinal port number (1-8) that 

is to be used foi the GET console. 

The Cjjeciiif-C terminal i-iist he configured accorcing to its permanent 
terminal turaj-e ters stoieJ ii, S *V aJU ; . ..hen CLT is enabled/ it aay fca 
activated in one ot three t»ays: 

o Unon entering a privileged OLT connsanc. 

u br-cj! a systei?. crash (1 clio«ir.g optione! Upline Dump, out prior to 
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self- test) . 

o Upon re-initialization (following Downline Load, but prior to start 
of normal operations). Note: GDI will NOT be enabled after a 
Poner-up, but after a software initialize only. 

when ODT is entered, any DDT command may be given (see ODT 
Specification). If the *G0* coaffianti is given with no PC, execution 
continues at the following places, cependirg on uhy ODT was activated: 

o Upon ODT cofflaiand, or ODT breakpoint - At the next instruction 

o Upon systejr crash - At the HG«-based belt-test 

o Upon software initialize - At the start of nortnal operations 

The ODT operation, SET SERVER CCIiSGLfc anc ODT conaands yili not be 
described in the nor&cl FGSEIGCK documentation set. Information 
regarding uuT operation will be proviceo to Software services anc Field 
service, and to certain customers as the need arises. 



4.0 PUELIC ATIOf.S 

The soitkare publica ticns supplied faith i : Ui£lijG'& are targeted lor t*o 
aiain audiences: the Terminal User and the Terminal Manager (see Section 
2.1). it is expected that these t*c groups of people will be located 

generally in the vicinity of the ICSEIDGI* unit, and that the 
documentation kill reside there also. 

For each terminal user, a PGSE1DUN USER'S CARD is supplied. This card 
contains a sunns ary of local mode operations and cosmands, and is expected 
to cover over 951 of the features that a non-technical terminal user 
hould ever need. 

One FGSEID0& OPERATIONS GUIDE is provided, *hich explains all terminal 
server features and more detailed operations. It is expected that this 
document is located with the Terminal manager, also in the vicinity of 
the POSEIDON unit. li a terminal user has a problem (or needs more 
detailed information concerning operations)/ he/she cay refer to this 
manual, cr call the terminal manager for assistance* 

One POSEIDGft SQt'TifcAftE INSTALLATION GUIDE is provided, yhich explains the 
software installation process for each type of host system on which the 

software is expected to reside. This manual is expected to be located in 
the fOi>ei»oion ui tn« Ucu iiOi>t oyb'tew ii?ducger, aiui NUT oe l.ocatea in tna 
.^rea of the POStluON unit. 

The contents of each inanual is as follows: 

o PGSEiDuN OsEK'b CAhu (t supplied per FGSfclDCfc); 
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- Local f^ode Operation Overview 

- Non-privileged Cofiffiand Summary 

- Status and Error fessayt Su&irary 

o POSEIDON CFErATICNS GUIDE (1 per POSEIDON): 

- Desc t ipticn oi all Teiiiiiridl Server ieatures 

- Local &ode Laser iy tion 

- Non-privileged cc&rcand descriptions, including responses 

- Eiiviieyeo co^ano oesci ip tions/ including responses 

- Maintenance Operations 

- tcasic Troubleshooting procedures 

_ i. >..< u ,-i — %.: . i „ ., 1 i u t >* -^ w .:. i j t. .u ^< s„ _ v» i. .i ^ L 4 u » . 

o PCSFItLN ^FTi»HvF ISsbl ALL AT ICN GLILc (i t si optional so£t*are Kit.) 

- Sottyare installation Procedures 

- Installation Vetitication 

- Sottyare Update (Autopatch) Inst citation 

Iniorrua tion oi interest to an overall tetMork manager, including a 

description ol the LAI architecture, aiessage formats and network 

troubleshooting procedures/ is supplied in the documentation set ior the 
LAT nost support/ ana is not packaged aith PGSEIDGN. 



5.0 PACKAGING 

The PGSt.lt) CI* software resides on a LOAD LCST system, ard is dcynline 
loaded via the Ethernet upon every PuSEIDGN initialization. «hen 
PGSEIDGK units are ordered/ the custotter/s-elesfflan should determine the 
nuirbpr ard tv^(i) cf load host systems. With small Ethernet 
coniigurations/ one or ttno load hosts may suitice. wiith larger 
iR;pJ Oiiient-ition»/ more load hosts uould speed the downline load process. 
f. rule cf thuiit might be tret CNE lead host is leguiced for every 10 
PlSEIuCN units installed, ^ ius uN£ spare. A Joad host »ust be configured 
*itn Phase f.V L-tCnei/ ana have a urXnet license. 

ashen orcering PCSEIDCN hardware units, the appropriate PGSEIDCN software 
neeus to be speciiied* It is also important that tne LAT host soitware 
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(in the iutm of a host-resident driver or laT host server) be considered 

at this tiflie. tor licensing puiposes, the loiioymg applies: 

o DHL FGoEiDtN software license is supplied for each PGSEIDC& unit 

ordered, and is included in the basic cost. This license allows the 

execution ci POSEIDON server software on the nard*are unity and 

coa.es hitfc a 9C-dav warranty. The following documentation is also 

provided for each units 

- L ruotiuuii ^iue ritt-eidtluu <mu iuotcfilclluu ouluc 

- 1 POSEIDON Operations Guide 

- B PUSLIDUN Users* Cards 

c A PGSFIDCfc software kit may be purchased, fchich includes 'binaries* 
supplied on an eppropriate disk, and ail software-related 
documentation including a 5G*'T*Ahfe. iw^T ALLi*T IQU GOut. This kit SBay 
ue loaded onto any number ol DECnet load host systems. 

o libit. LAT host software license aiust be purchased for each host that 

intends to support the POSEIDON terminal server. Right-to-copy 
licenses are available tor this soityare. LAI host soft«are and 

^DCi-Tf?r.t?t lcr '"lift * ,€ ? cr^erci ?s ^ sf , p?r?*tf > line it***'/ sn*? f»^y b*? 
shipped with the PGSfc'IDGN, or ordered seperately Irons the SOC. 



6.0 .U5l ALL ABILITY. 

The PGSLIDOn software is designed to be customer installable, and fully 

automated. The installation procedure kill be initiated by one or ti»o 
ccmmands entered at the load host system console, and yill be described 
in a separate Software installation Guide. 

All standard installation procedures for layered products (if any) will 
be applied. 

Updates for both POSEIDGN software will be supplied in Autopatch kits in 
the saffe manner as are updates for other layered products. installation 
instructions are provided in the kits. 



7.0 EASE-Gf-USfc 

The Local toode user interlace has been designed lor simplicity, and for 
cessation i ty kiln otnet DIGITAL rocai area terminal servers (such as 
Voyager). All coimanc's are in an hr.glisn-IiRe format, without switches 
and other unusual punctuation. Host cccess is by name (rather than 
r.thernet-irl). £ two-level fcELP facility is supplied, which shoys all 
available c onwards, and all options for each coffisand. 

The capability exists for a Terminal f.anaQtr to define a PftEFEfciifcD or 
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DEDICATED HOST lot each terminal, ana to set up permanent terminal 
chaiacteristi.es. In this hay, a tser nay tccess a terminal without any 
knowledge of a Local mede interface, since the terminal will be 

permanently connected to a host system. 

for the Local Mode user requiring more flexibility/ coanaands exist to 
display a list of available hosts, set and show dynamic terminal 
parameters, and to connect to and cisconnect from a specific host system. 
It is also possible to run a terminal test froffi a local terminal* 

The Privileged Local fcode interface has been designed for simplicity, and 
is specialized for the PLSEIDQN/LAI envir cnaient* A HELP capability also 
exists for Privileged eoamiands. 



8.0 PERFORMANCE 

6.1 Kespoiibe Time 

PCSfclDQa t\us Dten engineered as a nign-periorfBance terminal server 

;*ro<inct, -»!>!<* to provide *»i- K Tr?e'' teririnais 2 it!*- t^ throu^h^ut an:! 
response time expectec cf s locally connected terff.ir.ai, even under worst 

case conditions. 

Character-echo lespuriie tine is a critical performance attribute, and in 
the case of rCiifclDLfc/ is hi^hiy dependent on the value of the CIRCUIT 
TIHtR. For noraal interactive functiens, in which the host terminal 
cLbss driver echoes all input chatactets, the character-echo response 
tiae will aveiust. 0.5 tints the circuit ti&er, plus a s&all propagation 
delay. 

fe'ith the circuit timer set at the reconenc 80 bis value, this response 
tirae is between 40 and SC nis. Although this is numerically auch slower 
than a direct connection (such as a D211), a 50 ras {1/20 sec) delay is 
not noticeable to a hussar operator. In effect, the 'apparent" response 
time is the sanse as that of a local connection* 

This response time will NGT degrade upon meximum throughput through the 
server* It may degrade (as would a iccal connection) if a host system is 

over loaded. 

For application programs using the r eac-wit'h-no-echo functions, the 
character echo response time will average at least 1.5 times the circuit 
timer, plus propagation delays plus application program delays, kith the 
recommended circuit timer of 80 ips, this time will average at least 120 
i»s« For certain applications, such as EDf, which issue multiple write 
l/\j*to lot tuicu chccact^t typed, the response time may oe longer. 

fcnen a character is typec cr a blocK-rcde terminal, the typed "echo* is a 
local ecno* «o nost processing is involved. The response for a whole 

blccjt oi data sent is depenoent on the application processing time and 
the r?ost-PCbE IDL?^ throughput* 
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8.2 Server Throughput 

Server throughput is the number of bytes that the server can process in a 
yivtn airount ol time/ and may be expresses in terms of bytes/second. It 
is the GOAL of PGStUDGN to be able to drive lull-duplex output and input 
at 9600 fops (approx 960 bytes/second) on ail terminals* 

This performance is HIGHLY, critical on various code paths within the 
PUStlDGN software, and actual performance characteristics Hill be defined 

i i n n n i~ *■» mi rx I r\ 4- 4 r\ r>. n f ♦■ Ki c r* fs t*. r% »"i> r •" «rf -3ii-» iiiri c c|>nno c? t <-' that f hi c rt n -» 1 
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will be met* 

POSEIDON will accept line speeds of up to 19200 bps, but bill NOT support 
sustained input at this line speed. Terminals Must not transmit Biore 
than 960 characters per second at 192CQ bps, otherwise the server may 
idtuidte and Jctc. overruns way occur. In addition, even moderate bursts 
of 19200 bps input may adversely affect terminal output. It is therefore 
HIGHLY recomni ended that a line speed ol 192C0 bps be used CMLV in a 
human-speed lntut envicorment. sustained output at 19200 bps is 
supported. 



h.3 Ktnernet Utilization 

Lthernei {A) utilisation i£> an important consideration lor determining 
hoy many P0i»fc lDtJNs, and other processors, can be supported on one 
Ethernet. 

The nature of the LAT protocol is such that Nl utilization is lowest when 

the number of connected hosts is small compared tc the number of 

connected terminals, and highest uhen the nuaber of connected hosts 

equals the number oi terminals. The M utilization is highly dependent 

on terminal speeds, and also somewhat dependent en the Circuit Timer 
value. 

The following table indicates the korst-case scenario of 9600 bps 
full-duplex simultaneous rrput and output (or 19200 bps output only) yith 
various numbers of terminals and .hosts. 

The *kA* I* A T A *" utilization is simply the percentage HI usage that would 

be required tc trarsier 1920 characte rs/second/terfl'irai across the 
Ethernet yith nc protocol overhead* The IGSEIDC& utilization includes 
the LAT protocol overhead, yith tno Circuit Tii&ers values of 80 ms and 

30b»s« 

The i-eicciUciUeu r ci.ji tii»en t the actual utiiii.at.iuri oiviued by the 
theoretical ti'axi&uot for the Ethernet of 1.25 Mbytes/seconds (10Mbps). 
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Number oi Jiusotr oi Nl Utilization HI Utilization POSEIDON 

Terminals Hosts NAtf DAI A 80ms 30ms 



4 1 

4 4 

a i 



0.15% 


U.22% 


0.32% 


0.61% 


0.72% 


0.86% 


0.61$ 


0.68% 


1.27* 


1.23% 


1.40% 


1.57% 


•t -> -~ a 


X . J D t» 


-* q r» <is. 



b b 1.23% 1.76% 2.53% 

These are the worst-case utilization re^ui regents that o*ay occur kith one 
PCStJDCfi. In noma! usage, terminal traffic yill probably be 
intermittent/ terminal speeds may be lower/ and other factors combine to 

make tfit actual «1 utilization &uch lower tnan moicateo above. 



fa. 4 host ^erior finance 

A PisStlLLN imy ienjcntatioii has tne putentidi ox utilizing less nost CPU 
;<r oc«ss inu tnar. trac-itioral asy nchionuus interfaces such as the DZ11. 
This is because in ere host interrupt/ an entire LAT butter/ possibly 
containing data ior &any terminals/ «iay be serviced. The 9211* by 
contrast/ requires a separate interrupt ioi each character processed. 

The actual amount ol host processing detenus on iactors such m> Circuit 
Timer value and i/G length. Also critical is the amount ot processing 
per single interrupt (yhich is usany times more than that of a DZ11 
interrupt)* 

With these iactors in Kind, tne minimum expected performance goal of 
PLiS£IDGN (yith respect tc host processing) yith recommended parameters is 
to match that oi tae DZ11* It is expected that under most circumstances/ 
host CPU utilization yill be less yith POSEIDON tnan yith the DZ11, 
especially **hen large amounts of terminal traffic is involved, resulting 
in more host co&putt; pOkei available ior application processing. These 
expectations are dasec on an existing LAT prototype system. 

Actual performance a:easur e&ents fcili be fiiade after iffiplementation, so 
that performance characteristics aiay be accurately defined, and user 
expectations accurately set. 

Ail peiioruance estimates are mace on the assumption that the error rate 

ovei the ttnernet is loy, and tnat the trtiernet (and hosts) have light to 

moderate loazlz. Hn heavily-loaded rosts u.nd networks, the overall 
response-ti^e ar.o tiiicughpcut performance (as perceived by the useri kill 
he *ors*; taan stated dtiove. ho*evet/ a siniiar performance degradation 
wouio be oDieivta on any terminal /hos t system under the saae 
c i r c u w. • s t a n c e s . 
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9.0 KniA^ILITV 

Reliability is of primary importance ir a product with such high 
visibility* Ar, extensive internal and field test proyraia will oe 
undertaken prior to snipaent m order to eiiotinate all fatal software 
errors, and protocol violations. Shipment will not take piace if any 
fatal conditions or protocol violations occur without resolution. 
(Category 1 errors). 

V»fl tC*j'Vl jf *. C L i. V> A O UiC \J t, £ A i. C \^ Qi) Hi CI j Vi*. C A *. t *. *t Ulii^ti U V» *i W *. VOU<9C O Vr *. Q O » * / 

but result in the non-functioning oi aiajcr elements of the software, or 

cause serious per ioraitiiice problems. Shipment will not take place if any 
category 2 errors are kno*n. 

Category 3 errors are defined as miner errors, resulting in the 

hun-i uiictiuujuiy (or i*ditidl 1 uiiC t ioniiiy ) oi Uiiiioi elements oi the 

software or errors causing srincr performance degradation. Shipment will 
not take place kith any more than two (2) such known errors. 

Category 4 errors are defined as totally cosmetic errors, with no impact 
on functionality ano perloraance. Shipment will not take place with more 
trnfi tiv** ft:) 'Mirp »rpovp *rror^. 

Category 5 errors are suggestions at\3 docu&entdtior; errors. There may be 
any nuirfcer of suggestions submit ted, but shipaent will not take place 
witfs more tiidii rive (b) xnewn docuatentatior eirori>. 

Since FCbEIDGN contains a stand-alone software system, the following 
broad categories ot detectable errors, and fCSEIDGK responses, are 

defined: 

o Fatal hardware Error, determined by diagnostic self-test. The 
I'GSLIDGN unit yil'l not lunction, ano the nardware status light will 
retain oft. A unit replacement is required for recovery. 

o fton-fatal hardware trror- Tne hardware status light on the PGSE1DGN 
bill Hash, and an appropriate value yiil be placed in the hardware 
status indicator. Hardware status may be displayed using the 
privileged *SHG^ 5ERVFK* cosmiand. The unit will attempt to function 
normally with a non-fatal hardware error. 

o jf-atai Software ^rror, caused by a fat?l software bug or hardware 
error in server. A ci ash routine will place a value in the soityare 
status indicator, optionally upline diiap the PGSEIDGK memory, then 
initialize the server. This value may be displayed using the 
privileged *SHGw SERVER* command* If the software error was caused 
by a fatal hardware error, the initialization will be unsuccessful, 
d r c € h ti f l ■ 1 1 1 u l (4 u r 1 1 * i i i net f u r c 1 1 1 n • 

o LAI Protocol i'.rror, caused ny a soityare bug in server or host. An 
error iuessa^e mill be displayed en ail affected terminals, the 
virtual ciicuit wili be placed into the halt state, and all 
terminals will be disconnected. It Autoconnect is enaoled, attempts 
to reconnect to the ssae (or a different group) host will be made, 
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otherwise Local ftode feill ae entered* 

o LAI Timeout Error/ caused by a problet in a host systeau After 10 
unsuccesiif l1 retries, an error iye±aage *ili be displayed to all 
affected terminals. 

If AUTuCON^ECT is disabled, a iesssge is displayed indicating that 
communication *«ith the host is lest. however, PGSEIDOtf will atteiapt 
to re-estcolish coiiiffiunications, unless and until a DISCONNECT 

CQOiHaod is given* 

If AUTUCONiiELT is enabled, the connection is taken do&m, and a new 
connect request is issued. Il the specified host name is a GROUP 
naase, connection to another host m tre group is attempted. If the 
specified host name is a unique name, connecttion to the same host 

is ctttn^itu. The autocunnect usechaiiisai asay ue stuppeu by entering 
local mode. 

o Usei Input iiror, caused by a user entering invalid input in either 
Local or Console pece. An error nessage is printed out, and the 

entire cui&uand ignored. 

o uata Overrun Rrror, caused ny fi*ore characters being input than can 
be accoffiusocoted in a LAT buffer. This error can only occur if input 
fie* roptrcl is disabled, cr it the terminal has ignored the XCFF 
character sent to it watsn the buiier «as lull. The character is 
aiscaruec, disu optionally a b&L integ) code is output to the 
terminal- 



10.0 *»AiaTAl#AcIi-ri* 

Haintainauilty cf the PCSE1DCN softkare yill be enhanced by the following 

pro vis ions : 

o The PCSEIOCN Software Installation Guide *iil describe ho* to 
install updates of the software via the Autopatch mechanism. It 
will also briefly reference the VfeS/&SX EOT utility (described in 
the operating system documentation), fchich say he used for updating 
of the PfSfe'I'DCN software iirage ry Software Services or the customer. 
Patches may ce supplied by telephone, or through publications such 
as the Small Buffer. 

o Updates will be supplied in standard Autopatch kits lor layered 
products. The release of the Autopatch kit yill be controlled by 

the Oufcioiiisi. ayfet«i^. i'ne entile t-o&eioor loao image kill oe 
replaced ty Autopatch. This ul) aiirost certainly involve just one 
i i i u . 



■u 



The SeiVrir Softuare *iii be aodui et izec, *itn clearly defined 
interlaces. ^ocules s*ill nave cle*rly defined areas of interest, 
3no will net perrons tasks outside of those areas of interest. All 
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modules and routines will have their functions defined in block 
coaiutents prior to the actual code. 

o Microcode LDI kill be available, and this may be enabled froo the 
privileged terminal. On-site personnel »ay utilize this QDT 
capability, or it isay be utilized remotely over the teiephone (tor 
the modern control version of Poseidon), The OCT capability *ill 
allow examination/ modification of memory and setting of 
breakpoints* 

o An Upline Dun»p capability till be pioviaed, end Kay be enabled from 
the privileged teroinai. The dujap yill occur upon any POSEIDON 
system crash/ except that caused by the hardware yatchdog sanity 
tiffer. This duftp roav then be later cxasinec to determine the cause 
of the crash. A dump formatter program is being considered for 
release at some ti&e lolioymg toe initial PLiSbluUK release, and 
will be implemented or a time-available basis. 

o Mon-fatal error conditions will be counted/ and displayable using 
privileged local fcoce commands. 

~ T^c ~-:rv^r "cftk^rc kill £" completely cenrnente i, to current 
software standards, and all documentation conventions will be 
i'oiioyed. Following lap ie&enta tion, a maintenance guide *iii be 
written exnlaininy Lata structures, logic flci*/ error handling etc. 
This will oe compiieo iron? existing aesign specifications/ coameato 
in the code/ and new descriptions* 



11.0 MAINTENANCE (PRELIMINARY) 

11.0.99.1 Maintenance; Final strategy to be defined follouing Phase 1. 

Software maintenance tor PC5EID0N yill be perforaiec by the Distributed 
Systems soityara iuamtenance group. Customers nay report problems via 
SPR service or through a telephone hotline. Customers and/or Software 
Services may utilize the GDI' interface to more specifically diagnose 
problems. Use of this tool feiil be co-oroinated by the 
development/maintenance teatu in Softyare Engineering. It is NOT a goal 
for Coftuare Sprvices or the customer to independently utilize DOT beyond 
obtaining a register" printout or ae&ory duasp following a systeic crash. 
Neither softyare services nor the custoffier yill normally have access to 
the source coce. The software maintenance teaia »ay utilize the ODT 
interface directly through a &odea. line for the mctitm control version of 
Poseidon. 

It is expected thct the maintenance eifort tor PGSFIDCN **ill require 0.5 
persons for the first full year fron I- C 5 fcr PCSE1C0N software. 

The maintenance group will publish patches as necessary in the lolloping 

publications: 
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o Snail Buffer (for V^S and tlSX load host systems) 
o Large Entltr (lor TOPS-20 load host systems) 

maintenance releases will be mace/ if needed, at quarterly intervals for 

the first year following FCS. Fetches will be published in 

weekly/nonthly articles for iuore immediate application. The utility 
*fcui* jray be used to apply patches. 

Patches applied to FQSEIDGK will have to D€ co-ordinatec with patches for 
the LAI' host support- It is therefore planned to ship Hatching patches 
tor both siaes cf the protocol. 

Hajor enhancements tor the POSEIDON product nave not been defined/ but it 
is expected that enhancements will occur over the life of the product. 



12.0 COMPATIBILITY 

POSLiUCft, and the software which executes tpon it, is a new product. Its 

iurttiCi. i- tw ,:c t ^w ^ tcrn.irc.1 reiver en an Ethernet !oc?l area 
network . 

'"he : -Ll ; ii -n^se i 'Vo^aC'ti' L'loduct is a 52- leirsunal, ORCne t-coapatible 
terminal server on art Fthernet local area network. To facilitate the 
possible use of both servers in the saa*e er.vir diluent, the non-privileged 
HuScIDGiu Local fode interface and Voyager are cofiipatiole. 

The PUScliJUft rriviiegec »oce interface, being heavily involved with the 
LAT architecture and having its own mainfe nance functions, has its own 
interlace. This interface is patterned alter the EECnet Network Control 
Program (ftCP), although by necessity there are many differences. 
LAT-related privileged commands are compatible with other LAT-based 
terminal servers. 

PLbtlDCft sortwaie adhetes to the Local Area liarspcrt (LAT) architecture 
specification, and is designed to operate with any system that supports 

the host implementation of LAT, with tne Interactive Terminal service 

class enabled. 

rcSLTLCK adheres to all requirements cf the Ethernet version 2.0 
specification, and implements the kEPL^ and FGR^AHD MESSAGE network 
management functions cefineo therein. The Ethernet physical link and 
data link layers are performed exclusively by POSEIDON hardware. 

PUSEIUQw adheres to all r equireasents of the DIGITAL fcl noae architecure, 

ahC supports the LLC;- StRVEx, IDfc NT it \-StLt , KLAO-iu£f»TlT¥ and tffcAD 
COUUTL^ functiens. rCGIIECK also implements the optional LOOP REQUESTOR 
functions, since network fi>anagefcent is locally initiated. 

Except loi the downline load/ upline dun£ functions., PiiSLIJCN does not 
interlace *ith DRCnet (or any other network protocol), but nay function 

in roth DzCnet anr- non-Dtunet host en vironnen t s. FCSEILGN is compatible 
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yitn CiLCnet-suf plitid host names, arid DECnet-iBOGiiied Ethernet adoresses. 
The LAT software in the host systeis is responsible tor reading the OECnet 
host naae and Ethernet address, and responsible for sharing the HI port 
driver kith DhCnet. 



13.0 EvGLVaBILIT* 

The current plans are to ship PCSEIDCh software as an English language 
product. Software engineering does not intend to implement foreign 
language support* hut has provided the hooks to fflaice this possible. In 
particular, all hard-codec English-text has been consolidated in one 
section of the program, fcith a conditional asseaibly parameter. Space has 
been reserved icr an increase in code ^Izh that might oe experienced **iien 
3 language conversion takes place. In addition, the capability exists to 
define an alternate lead image tile r.a&e and the format of the existing 
name lakes into account the language used. 

If a language ynich requires an d-bit character set (in local mode) is to 
be iropj eperted, certain metiers of tr*» T»»rrir?l *crt ^orule viill require 
oiodiiicdtion. lhes« sections nave also he icentifiea by (another) 

conditional assembly parameter. 



I'ae ij.odeBi control version ci i-oserdon has already been 
u^tiQ yitn u?osi .r.urop«an OiticeSi/ as per PLC standard 052. 



designed to be 



The FQSEILGN coce yas ffoduiarized for possible ii$piei»entatior< on future 

product?. The Protocol and Usar Interlace module «ere &aae (virtually) 
indepedent of the hardware environment, except for the CPU type. The 
terminal port iscduie and NI port module are harcware dependent, hut their 
interfaces with other modules are not. 
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CUbf S 



PGStlDUfc Transfer 
iuanuf actor ing. The 



optional ltei 



costs are 
cost of prod 

costs 
«bich is ordered as 



based upon the cost of hardware and 



producing software docusientatio 
but the software leveiopffent costs are not. 



n is included. 
Software media is 



j ine itejs (at reedia cost). 



an 



Excluding the software media cost, the PGSfclDCN kill transi'er at a price 
oi about $500 lor the non-ttoden version. The Oioceffl control version yill 
transfer at about $600. 
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yi^&lltibbh, CG&SThAlNTS AND TKADF-G*'*ii 



The PUSMDGN product must be ready tc ship in Ql 1985. The software 
development schedule, risks, dependencies and requirements associated 
yitn the development effort are defined in the PQSEIDGN Software 

Development pier* 



This section 
implementation 



lefines contraints and trade-offs that may afiect 
ot f eatures/pertoraance that have been described in this 



ri r>. f i i m ont 



The uidin constraints affecting functionality concern memory utilization 

and execution speed of the FC^EiDON softyare. 

Preliminary analysis has been performed on execution time based on an 
7*36 ELz rtCGSOCO Pi.oce.sSui, *hicn indicates tnat tae perioraance yoai ot 
96C0 bps full-Jtplajc kill be met, if an appropriate Circuit Tiwer (BO ws) 
value is specified. Use of shorter circuit timers, exceptionally heavily 
Ethernet trail ic and otner considerations may aiiect this throughput 
goal. Performance nil he measurec fcilefcire, implementation, and 
supplied faith the final dccLKentation* no dropping oi functionality is 

The reac-oniy &eajGry available for the PuatibLN initialization microcode 
h?s Ceen iimtccf tc t KB, and the cuitnt estimate ii 6 KL. The 6 K:a 
liiiiit iuust not ue exceeded. ihe roiloyirig is a list ot trade-offs for 
the tu^tluLh microcode, it the i&ercory allocation is not sufficient: 

o Diagnostic Status reporting Uiechanisia *ill be abbreviated. (Message 

codes instead of English text). 

o Controi/P re-initialize function yill be eliffiinated. 

o Autobaud function kill be eliminated, and replaced yith output only 
with terminal parameters stored in M HAM. 

o Teitiary Loader kill te replaced with a Primary Loader (or seconuary 
loader). 

The downline Iceied software must fit into the 32 >'B allowance for the 
non-diodeia control version of PGSfclDCN. Aacitional Code and RAM estimates 
for wodew PUSFIDON and reverse POSFIDCf? jntst not exceed 12 KE. The 
current estimate for the non-mode ft control version of POSEIDON is 26.25 
K£. The lolloping features yill be traded off to ensure adherence to the 
32 h& 1. iifiit; 

o The undocumented ^LftiTLK command (which presents a continuous ShGW 
uisniey rot v f lOO-co^nc* tiei e teraifialtj kould be dropped. 



o Local roce sup^ott fci VT1G0 escape sequences, and terminal type 

*ANoi* would be orop. t -'eo. 

o Full two- level HLLP fscility (coipa title Kitfc VAX, RSX etc) fcould be 
replaced by a ^ELP facility containing the tollcying capabilities; 
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i.i E L P 

HELP PRIVILEGED 

HELP TEhKlKkL PARAMETERS 
HELP StHVEh PARAMETERS 



o Specification of Server Naiee and Location would be dropped- 
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APPENDIX A 
DRAFT SOFTWARE PRODUCT DESCRIPTION 



PRODUCT NA^fc,: PLSEIDOh Version 1.0 

Ethernet Terminal Server 

ufcSCRiPTTGN: 

POSEIDON is en Ethernet-based Terminal Server product *hich alloys 

up to eight interactive terminal users to communicate with host systems 

on the Ethernet. The software is doynline loaded into the POSEIDON Terminal 

server hardware IroJt; a VAX/VKS system running CECnet/VAX. When loaded, 
terminal users uav access i thernet-nasec iicst systems yitii WAX-li LAT support- 
Features: 
A LLCAL !*GDE interlace is provided, alloyirc a Terminal User to: 

w C0LN1CT to any authorized host system on the Ethernet 

o Pispia.y a list ot available hosts 

o ^f I arc b«t^ tetH irei pacanetecs, and ^erwanertl y retain theo 

o T+IST the terminal iot correct operation 

A privileged LtiCAL fcuiiF interlace is proviced, allcking a Terminal Manager to: 

o COhNtCi any terminal to any authorized nost system on the cthernet 

c SET and SHC& any terminal's parameters, and permanently retain them 

o SE1 and SHCfe the Terninal Server paraceters 

o SHCtf Terminal Server characteristics «nd counters 

o Perform Ethernet maintenance functions 

ft HOST «^CDE interface is provided, thereby a Terminal User can communicate 

with an authorized host s.ystefiu 

Support is provided for the following CIGI1AL terminals using the EIA RS-232C 
CC1TT v. 24 serial line interlace: 

VT100, VT101, VT102, VT125, VT131, VT18C 

VT50, ¥ 1 1 2 , VT55, VT6^, G1GI 

LAlZ, LA34, LA36, LA3fc/ LA50, LA10C, LA120, LAlfaO 

VT20C, VT220, VT24C 

Support is provided lor tne following terminals, then in terminal emulation 

h a if»bUi»-lU0, Qf-.Cicate-T I, PHCi-325/350 

Supported line speecs are iiom 50 to 192CU ops in Pine Mooe, and irom 50 to 

9600 in Lj.ock fcede { VI 125/C IG i ). 
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The PtiStibQk Tetoiinai Server ire* lesients th€ Local Area Transport (LAT) 
architecture between server and host. LAT support is also required on the 
host systems to be accessed* 

Cther features include: 

provides security against unauthorized access to any PGSEIDCN functions 

o Full XCfF/XON ilow control between terminal and Terminal Server/ which 

may be dynamically enaoled/disabled by the user 

c .Automatic teminai s^eec cetectior 

o Automatic CGNNECT to a DEDICATED or PREFERRED host system/ the naie oi 
which may be stored persicnentiy 

o Access control, iiniitiny accessibility oi certain hosts to certain terminals 

i r-. f f » \ q I p n 'riicfnm* r) \ 5 r 1 jp V 0!" ?* V ? I 1 c? t* 1 *? I'- O *? t 5* 

c function^ to ci^tiilute terminal c enrect iuns across hosts within ¥Aa clusters 

SuUkCl CODE IfeFlkfeAllUN: 
No source code i^ provided 

fclNI^UH HARDWARE REQUIRED: 
POSEIDCN Terminal Server 

Any VAX-U/73C, waX-11/750, VAX-ll/7bG ana kAX-li/782 syste« with a DLUNA 

Ethernet to UMHUS adapter. 

n u f inrsr t ? a n r- u? a r 5 * 
m J, 4, i >. 1 »* « L> i > « .t\ l_< •« « n ; ■ » 

N'one 

PREttFQUISIIft SHFTk k*El 

For the ^uSLlDOk Terminal Server: None 

v cr tne VA*/^* system that is to support co^nlme loading: 

tj t V * *■? *» *' "'* ''. 

¥ « A / * t"i O V ~* • W 

DrXntt-VAX V3.0 
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Fci the VAX/V^S system that is to support ierrainai Server Operations: 



VaX/VKS V^t.O 
VAX-11 LAT VI. 



OPTIONAL SGfTftAKE 



TRAINING CfiEiilTSi 
None 

SliPIGkT CATLGGK'V: 
DIGITAL SuPPUfcTfcU 
PGSLIDCN VI. is a DIGITAL supported software product 

SL'FT*'APh installation: 

CLSiO^Lir Ih^TALLLi-/ 

rcsriDCN VI. C il engineered to ce installed by the Customer. 

ORDERING INFO&fcATlON: 

Ail binary licensed soft*iar«/ including any suose^uent updates/ is iurnished 
under the licencing provisions of DIGITAL'S Standard Terms and Conditions of 
Sale, which provide in pait that the software and any part thereof be used on 
only the single CPU for which it is intended/ and say ce copied/ in yhole or 
in part (with the proper inclusion of the CIG1TAL copyright notice and any 
DIGITAL propriety notices en the software) only fcr use on such CPU. 

nations wxtii no support services are only cvailable after the purchase of one 
supported license. 

A single-use/ license-only option is a license to copy the software previously 
obtained uncer license. 

The following Key (G,V,Z) represents the distribution media fcr the product and 
must oe specified at the end of the order number/ e/g/. Qh,xx:x-A¥ - binaries on 
SX01 Floppy Diskette. 

Q - TU5e DcCtape II Cartridge 
v * = r'AOl r loppy Diskette 

Z = No hariynre Dependency 

Sep TaoH T (or .iVdii.ab.ic options 
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+ , , — _.. ., ... , — _ 4 

j Jpticns 1 System J 

+ , . , . , -«, — . — , , — + 

i 1 »AA-li//BU | 

I 1 VAX-11/7J0 VAX-11/750 VAX-11/782 I 

+ . _. ., , + 

I bingle-use license, binaries, J j 

i i'iA/Mi.T.ar.tati ii r\ . Qinvrnrt <J 4; *~ c i C f «. v v v — a r* n f! — v y v — A P nf'-vvY-f V 1 

| uv^uiiCti uuiiuii/ uvifjj'v/kv w»^«-> i tt v nA* no »*-» A -A A « VJ *g u AAA f\ I | 

+ . , ■ -, , ... , . -_, , ___, . _ + 

I Single-use license, no binaiiesj | 

i no support. Documentation \ QC-xxx-bl kL-xxx-DZ Qc-xxx-DZ i 

+ _, — , . , — , , , -_. . — . + 

y T* r> t- t> r f * * * r r- '~ rf -r .-» — •-< ; 

(4UL ! ii.ll,lli Ml* JT.tV 1 ? 1 U il Ci » 

*?* i ■• o 

i. o O 
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AFPEraiX 8 
PCShlUfla ADDRESS StACE 



1C0040 
1C0000 



tnernet Address (ROM) 



itieooo 



182800 



liiOQOu 



Initialization 

Microcode («CH> 



Liagnostic Soityare 
Area (RCfc) 



6 K i 



10 K 



1 V ^ 'X v Y 

1 60Cu 



I Chip I/O Page 



iuuo y o 

100000 



DUART I/C ^a*,e 



cOaCC + ■ — — -♦ 

l l*on-vcia tile Memory j 

I Parameters 0.5 K I 

8 0000 ♦ -+ 



^OuUO 



i 

I 
! 
I 
I 

i 
i 

2UC -f- 



Randois Access Memory 

P.hh Area 
(Details on Next Page) 



Vectors 



ij •#- - 



i 

127.5 K i 

■■ — + 

, + 



POSEIDON Software Specification - CGfcPAN* CQhFILEUTlAL 
APPEkLIX k - PCSfclDCK *£*Gfc¥ LAYLUT 



Page 74 



20000 
1FF80 
lPtiOC 

1F000 
1C00C 



1380 



ICoCC 



PUSEIDCN *£J*GfiY LA^CliT 



Initialization R 



Stack 



High Peel Area fot 

iiost Data Base and 

Dyr.affic Data 



LOk Pool Area tor 
UAT Control cIocks, 
Tfaiu-ii-it I'i u £ t e r s 



123 d i 



3*S2 fc J 

.... — — + 



35 So b I 



eserved for future j 

implementations I 

12.0 K I 



34.0 K 



14.0 K 



8600 

8200 



deceive Buffer Area 

20 Bu£i.eti> Q 1536 each 



LAI Software and 
Pure Data Area 



30.0 K 



Miscellaneous Data 1.5 K 



'00 



(Vectors) 



J £. • y i\ 



C.b fc ! 
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uUh-yCLAIILfc HifcCHY. LAVOliT 



Circuit Timer 

Keep_A.Iive T inter 

Server Number 

server Type 

Server Naise Length 

Server Name 

Location Length 

Location 

Privileged Password Length 

Privileged Pcsssorc 

Logon Password Length 

LOijon Password 

Server piags 

Spare 

Checksum 

i.i 3 r u h a r e s t a t u s 
Diagnostic Test iyte 



i 


byte 


i 


byte 


Z 


bytes 




by tes 


1 


byte 


16 


bytes 


i 


by te 


16 


bytes 


1 


byte 


6 


bytes 


1 


byte 




bytes 


1 


Oyte 


13 


bytes 


i 


c y t e s 




byte 


1 


oyte 











i 


byte 


\ *- m:indl 


r a f <i W- 1- t e r fc / 


T fc t" Hi! ii.;3( 1. 


1 


b-e 


by Ifei 


T e r Ji: i n a 1 


Par sireters/ 


T e i a i n a 1 


2 


£4 


bytes 


Terminal 


Parameters, 


Terminal 


3 


£4 


bytes 


Terminal 


Parameters/ 


Terminal 


4 


54 


bytes 


Term mal 


Parameters/ 


Terminal 


•*j 


±4 


bytes 


lerminai 


Parameters/ 


Terminal 





Zh 


bytes 


Terminal 


Parameters/ 


Terminal 


7 


54 


bytes 


Terminal 


Par sj&eterss 


Terminal 


8 


54 


bytes 



000 
001 
002 
004 
006 
007 
017 
018 
028 
029 
2F 
030 
036 
037 
044 

045 
46 
047 
4F 

050 
08fc 
0BC 
0F2 
128 
15E 
194 
1CA 



GRAND TOTAL J 



512 byte; 



200 
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AFFENLIX C 

CIRCUIT STATE TAhLtS 



+ . — . , . — . — - ~- ■♦ 

i HALT STATE: Even t_act ion Next_state| 

+ ■ ■ - ■ + 

1 - Ci rcui t__ tifl*er_event CRASH HALT i 

I - Res^Gnse_tifteoii t_ event CRASH HALT I 

j - Keep_ali.ve_tiasei_event 1GNCRE HALT I 

j - Resend_ limit_event CPaSH HALT j 

j - Star t_ir>€SS3ge_r€ceiveo Send_stcp_niessace HALT I 

j - Stop_message_received IGNCSE HALT J 

{ - P.un_nit;s*aye_recfcived ijend_stot_ftesi»d<ie is ALT i 

i - Invalid.nes^age.receiweti it stop^ttessage, ignore BALT j 

| else send_stop_jiessage HALT | 

| - Illega'i_iitessage_received Send_stop_ffessage HALT i 

j - Datu.kijiting CRASH HALT J 

+ ■ ■ — • - ■ + 

I - '"ir^nit rcnr^ct '^rl st^rt ^^s^?;^ START 1 

i - CircuiCcjiscormect CRASH ~ HALT I 
+ . . , , + 

+ , . . . , , — + 

j STilhT STA'iE; t, v&fit.acticn* Next_atate| 

* .— — .— — . . — . — — — - — — . — - — -. 1 — — ■ . — — ■ + 

J - Circuit_titt$er_evGnt IGNCKE START | 

I - Response_tiisieout_event fce - sen<J_stert_iB€Ssage START ] 

1 - Keep_alive_tiiaer_event IGNORE START I 

| - kesend_liiijit_eveijt Deiete_terBiriais>> delete_circuit HALT I 

I - 5tart_reesiage_r€ceived istart_circuit RUN I 

j - StOi> g- iiiessagfc_receivtjd Delete.tfcraiinals^ delete_circuit HALT 1 

i - Rim_ffiessage_receivt!d Deiete_terfiiinai£, delete_circuit HALT I 

| - Inval id_flses;>age_ received Deiete_tem;inal£s delete_circuit riALT I 

i — I Ilts ya i__n»essay *s_r fcce i'v tiu Leiete._teri6ina.ls/ delete_circu.it liALT I 

i - Oata_waitmg iGNOKfc START I 

+ . < + 

i - Circuit_cormect CRASli fcALT J 

1 - Circuit_oiJconnect beiid_stop_ffiesaage, delete_circuit ft ALT i 

+ .. , . . — . . . . — . — — < . + 
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VI ATT STATt: 



£vent_actions 



Next_statel 



1 - Circuit. timer_ever.t 

j - Kesponse_ti&eout_event 

1 - Keep_ai ive_t ii«ei_tjveiit 

| - Resend_liioit_event 

J - Stai:t„i6es:>age„_receiveti 

I - Stop_message_received 

| - Run_ff:essa-ge_reccived 



I rival id_wessage_received 
11 I eg a i_mes&age_ received 



— D a t a_ in a i tiny 



&one «AIT 

fte_send_riin_»essage MAIT 

«one nllM 

^arn_users WAIT 

iNone HUN 

Oeiete_terffiinai£, delete_ct icuit HALT 
Process_rijri_ message, 

If data_ilag__,set RUN 

else *A1T 

f^one BUk 
Send_stofc_.Hiessage, eel ete_terainals, 

oelete_circui t HALT 

Kone HUH 



Circuit. disconnect 



:e nd_s t o p__B essa.8/ d e I e te_c i r cu i t 



HALT 



- Circui t_timer_event 



i - Resionse.tiiiieout.event 

I - Keet_.dlive_ti»er_event 

i - Resend_liinit_event 

j - Stait_Eessage_received 

| - Sto£_.fljessage_ received 

j - ttun_message_receiveci 

j - Invalid_iressage_rfcceived 

j - II 1 £ era I _Wi&Sh ag £_r ecs iv 6 d 



t/vent actions 



Next__tate I 



- Da ta.wa i ting 



aend_run_»essage/ 

It data_stili_waiting «UN 

else.... iiAiT 

fie_send_r uncases «age ftUN 

IG&GkE kUa 

«acn_useis RON 

None ftUN 

Lelete__ters.inal£/ deiete_circuit HALT 

rrocesa_tui]_iesidge RUN 

lione SUN 
Send.stof_Ecscase/ delete terminals/ 

delete.ciccuit HALT 

Aione RUN 



Ci rcuit_connec t 
Circuit disconnect 



CRASH liALT 

Send_stop_&essage / ie lete.ciicuit HALT 
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APPENLIA D 
SLCT STATE TAiiLES 



HALT ST Alt: 



£vent_acticns 



Mext.state I 



y Vtll4UN# t* A* W M "*•* 't!U *J 4* 



i - 

I - 

I - 

i 
i - 

4 



Star t_siot_ receiver] 
Stcp_sic t_rece ived 
Reject^slo t_receiveci 
A ttenticn_siot_ received 
I nvalid_siet_ received 

Tl BUS ml t__i3i O t_pi. OC £}£»■£> t. u 

Disconnect_reques t 



x^ *. G a «• v» X. 6 <■ «i lnui y 


c i» r» 


CL 


.starts 


_,«*» *■ X 


START 


I 


Send_3tog_slot 










HALT 


i 


None 










HALT 


i 


ftone 










HALT 


i 


None 










HALT 


f 


None 










HALT 


* 


Z a 1 e t e_ t ti r Us in al 










HALT 


I 


CRASH 










HALT 


I 



START STATfe; 



Event actions 



Next_state | 



- '*onnect_regucst 

- 3 to*. t — slot — receiwe J 

- S to^si u t_i eceiveu 

- Re ject_siot_received 

- Attenticri_siot_receiwed 



1 - Tn-Vtilid.slot.rtjciived 



- Transmit_slot_?rocessec! 

- Disconnect_request 



CHASr: 

3tart_tei&mai 

yjonti 

Oeiete_ter&inal 

&one 

None 



H ALT 

START 

HALT 

START 

START 

START 

HALT 



RUU STATE: 



vent action, 



Next_state| 



Connects re quest 
Star t_slot_receivecl 
S t c p_ s i c t_ r ec e i v e <i 
fce ject_ sic t_ receive G 
Attention_slot_i:eceived 
Invalids lot_ received 
T r a r sm i t_ t> i o t_p t oce s se d 
Disconnecter ^quest 



C R A S h 

None 

tie let e_ter»i rial 

None 

P r oc e s s_ a 1 1 en 1 1 en_s lot 

Send_stop_slGt 

None 

Send_stap_slot 



hALT 


i 


RUN 


i 


HALT 


« 


RUN 


I 


PUN 


J 


HALT 


1 


RUN 


i 


hALT 


i 
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AFPENDI.X £ 

HESS^GiL FCkHATS 

There are five types of messages exchanged between server and host 

Cbhr IGUnATIOfty FAlCd/ 3TAtfT# RUN and STOP, formats are shown below: 

£.1 CLiKFlGUKATILN Message Format: 

i *; o 

A. -*J V 

+ -. ■ + 

\ Destination J 

I Address j 

J 6 I 

4 . . . . , . 4 

| Source J 

I Address j 

I 6 j 

4 — . , + 

I Protocol Type 2 J 

4 — , , , . , — -.—.. 4 

f c \ r<~\* i t_t ippr j **»ss3ge_t }ts ] 

4 . . , .», , _ + 

I Lc_L AT_version j lii_L^T_ver sion I 

f , . * 

1 t t u toccii_t-CC i Pro toco inversion I 

+ — , , , + 

1 Change_ilags J $sg_incarnation | 

+ * ■ ■ — ' + 

j Bos Derating I i^UMber_oi_iiafi;es i 

4 , — . — _ + 

I I Host_naffle_ leny th i 
I + Z .. + 

mm am 

| bC6t_name I 

i 1-16 i 

4. , — — . , — . . — . — ~ — 4 

Lest_three_lields repeated 
"nufliDer_o renames" - 1 tiiees " 

+. . . — . , , 4 

I I Ident_ler.gth I 

i 4-— ~~ - 4 

mm mm 

i Identification 1 

I l-6« J 

+ , _ — 1 

I j %'u!i:fcer_ci_ groups I 

I + 4 

i Grot*_codes i 

i 1-16 i 

4«. . — , , — . -. 4 Continued*.... 
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if! 



Continues 



I NUBfc eraser vices j 

4-. . + 



Serviceciasses 



i 

1-255 I 
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3 STAUT Hessaye Format: 



15 

I Destination 1 

j Address J 

i 6 i 

.4, ... , 4 

I Source ) 

i Address I 

I 6 I 

+ , --, , . — 4 

1 Protocol Type 2 j 

♦ -- — — -■ ■* 

I I astj_tyte (4/o) I 

4 . , , , , . «— — — f 

I Les tination.circuit.ident if ier J 

4_. — . — , . «-, ., — ., — -. . — , . — 4 

1 $Qutce_ciicui trident if ier J 

+ .-, -. ... . — - — — ., + 

! •-"».. -. 1 3 ~ ... _ , — * !' 1 C ,■ .... , , ,-. .-, -, }t I 

i hviUjJ * A - <i yj i_- IL «- 1 I }, j ^t^tUiiCv. ., I 

+ -■ ■ . ■ 4 

J t*!a.xiiiiuns_datcs_iifik_f rame.size | 

■■#■ ■ — • •* 

j Hdroyare | 

i Ethernet j 

i Address b 1 

+-. . , — , — . , — . — 4 

J trotocol_fcCC I eiocotoi.v trison I 

4— , . . , ---.. . 4 

I C I Ma.x_KuiiJ3er.terffis i 

I Keep. alive. titter I Circuit.tiajer j 

4 , . . , , 4 

i Server.nuaiber 2 j 

4 , . , — 4 

t Server. type 2 j 

4 , . ~ . „— -4 

i 1 Length. oi.Laise i 
I 4 4 

I Server name 1 

i " 0-16 1 

4 ~ , , , . — - — -. — — 4 

1 j Location.l fcny th i 

£ 4 4 

i Lccaticn J 

I 0-U i 

4 . . 4 
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£•4 kUf* i^fcSSAGE FORMAT 



15 

•4--- --' ' --—4 

i Destination i 

i Address j 

i 6 I 

+ -., - + 

i C r> i ( t f *» 1 

| u v< %j i. v» t j 

I Address i 

J & | 

I Protocol Type 2 j 

4 . , ■ , .. . , ., —4 

I wuu':b cr_oI_.i» lu tb I «->S«.ty^e (0/2) I 
+ . ... ., , _, — , . — , + 

j l5€3tii}ation_circiiit_icentiiier j 

I Source_ciicuit_identif ier t 

I &ckno*l fone«i«Pt M Sfqu^nre II j 

4.-. -, , _ . 4 

« • 

* • 

SlCI DATA 

C-1492 . 
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SPPEkDIX E - MESSAGE FLRHATS 

t.b HUfc M^SSAGt^ SLUT tUh^ATS 

Start Slot Data_a Slot Stop/heject Slot 

7 7 C 7 

* ■ ■ -4 4-~ — ■ 4 4 ■ ■ -4 

I Dest_slct_iderit I 1 Lest_slot_ident 1 1 Oest_slct_ident 1 

4 ------ , 4 + , __. - * 4 . _. -. 4 

lSource_slot_ident 1 i Source_sIot_ident j | Source_slot_ident j 

4 ■ + + ■ ■ 4 4 4 

i Pyte_coimt J J Pyte_ccuEt | I Byte.count I 

4- _, , _, , -.-4 4- . ---. . ... 4 4- — — _, _, 4 

I Type 9 I Credits | J Type I Credits | \ Type N I Reason | 

4 = = = = ===: = -=:=- ==:==::=:= 4 isi:s: = 5:s2ssr::: = :^ 4 = = = = = = = = = = = === = = ==4- 

1 Service.class 1 1 i J 

+ , _ + - siot.uata " h-12 iitop Slot 

| Attent *n_siot_si2e j i 0-255 | fc = 13 Reject Slot 

4--' ---. 4 4----------- «.-, 4 

j Data.D_slot.size j 

4 . , 4 

| Data_a_slot_size | 



Dota_fa_5lot A tention_sio t Credit_«iithdrawai_slut 

7 7 C 7 

4 , — 4 4 , , 4 4 , + 

i Dest_siot_iden t i i liest_slol_ident J I Dest__slot_ident i 

4 . -_ --4 4-, . -. , —4 4 . ■ , — . + 

\ Source_siot_ident i i Source.slot.icerit j I Scurce_slot_ident i 

4 _4 4 , 4 4 , 4 

I Byte_count i I Byte.count I 1 Byte.count 1 

+ — ' -' ■ 4 4- ■ -4 4—' ■ — ' ■ — 4» 

! Type I0i credits j i Type 11 1 j J Type 15 i Credits 1 

+ == = = = ■= = = = == = == = = = = + 4 = = = -= = = = = === = = = = = == 4 4- = === = = = === ==== = = ==4 

1 Cuntrol.f la^s I i Cortrol.t lacs j 

4-- __ --- 4 4 --. — , 4 

| GutfUt_XGFF_char j 

4 , + 

I Gu t^ut w XGw_chdi i 

4— ~, -, , — 4 

j Inpui_XOFF_chai I 
I Input_AUN_cha£' I 

4 . , + 
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E.6 5TOP Message Forniat: 



15 

+ . . . , , — 4 

J Destination 1 

i Address J 

i 6 i 

+ ■ ■ ■ ■ ■ — + 

i Source I 

I Address I 

i 6 i 

+-. -. . — — . + 

1 Protocol Type 2 I 

4> . , .- ..., --, - — -- — __-. .4 

i j| fcsg_type in/ 10) j 

.+ , . . + 

i Oestinat ion_circuit_identit let I 

4 , — — . . ^ 

j o i 

+ — .., _. _4 

: ! ? I 

i hezson^iengXb j *<€ason__ccde j 

4 . , 4 

i i 

*eason_text 
i j 

4 4 
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^on-irrivileged; 



F.i SHOW CONNECTS 



APPENLIX ir 
SfcC* DISPLAY fCH^/TS 



host : 



k_ fa A i l. c, or 
DELPfil 



AX/V*.S Developaent Systei 



F.2 SHOV! HOSTS 
Host ^a$e 



Status 



Identification 



HS_CCMPUTEiS. .. . 

L< t L> r 1 i i. «.*.**• . 

D 1 An ••».*••**• 



• • • » 



«L ii 

iiL.KU&D..... ••*••. 

) ,* A U I; • « •«•••••■•• 

U K C • •••••*••••••* 

L A U U U o * • •• • • • •• • « 



teachable 32-cit Advancec Development systen* 

Lnreacfcaole VAX/VHS Development 

Lverdue RSX-11M Deve ior-ment System 

Lrueacnaijifc kSX-liN-t'Lu'S oeveio^irseni System 

HeachaLle L'istr lotted Jystefl=i> Software Development 

Reachable Distributed Systems Fngineeiing 

beacnaole 



F.3 SHO« HOST SLKGND 

ELkCND keachaole Hating: 25 Connected Terminals: 2 

fiSX-llfc- PLUS Develop&ent System — Distributed Systems Software Engineering 



Seconds since zeroed: 277182 

messages Transpiitted: Ib79C2£27 

messages £e-transmitted: 2891 



Messages Received: 17872872 

Cii^licates Received: 1127 

illegal Messages Rcv'd: 1 

Illegal Slots Kev'd 2 



i> h Q ; 



Mfcf AL 



Teem: 




»A1LF; 


Y 




iccess : 




>*/ v; 


( T H/\ 


o 


Type : 




ANSI 


( Ah; 


U) 


Autoconn* 




t.' ».■ s 


(F.?,, 


*) 


} j :u6ti CI, 2 J 


» -* 


r. ■ i\ f> 


(Eli 


'» } 


Loss Not 4 


':n: 


ry 


(Ci^i 


u 



Current host: 
Preferred Host: 



(K.PAILEY) 

I/P Speed: 960C (96C0) 
Ci/r speed: 9oOG (96CQ) 



cnar Size: 
Parity: 
s tor fits: 



b (i ) 

NL?;£ (XCh£) 

(2) 



SMUG (SN AUC-Cedicated) 



T/P Flo* Ctl: EM (FMA) 

U/P f lote Ctl: Ehk it.Uk) 
Framing trrors: 

Parity errors: C 

uvetrun Frrors: 
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Priviieqed: 



F.5 SHO^ ALL CONNECTS 



Terr*: 
Host : 



b_^ANM 
DELFhl 



vax/V*»S Development Systei 



Term; 1 
Host : 



D.GATTGN 

* LOCAL * 



T e r m : 2 

Host: 



R_GFUDA 

ORC 



Distributed Systeas Engineering 



Tern* 2 3 
hos t : 



* LOCAL * 



etc etc 



f.o SHU« COUNTERS 



L'liittihLl CLUSTERS * 



jecorns oiuce zeiot'-d: 
Byte:. received: 
Bytes Sent: 
Frames Received: 
» rapes Sent: 
multicast Bytes Hcv'c: 
Multicast bytes Sent: 
Multicast frames Pcv'ii 
Multicast Frames Sent: 
F raises sent, deferrec: 
Ft awes sent, 1 collision 
Fraroes sent, 2-*- collisions: 



Yiiz 


17JP&F1 


789763 


!2bSi 


llc27 


i'/ei 





17te 





1* 


1 


: 



Lxcfchbive collisions: 

Carrier Check failure: 

Frame tco long: 

heartbeat absent: 

Late collision: 

Lata uncerrun: 

Block creek errcr: 

framing error: 

Lata overrun: 

System buffer unava liable: 

User buffer unavailable: 



* SERVfcF COUNTERS * 



Messages Received: 17872<b72 
Messages Transmitted: 187902827 
*eb£aqts ?e- ttansisi t teu: 2G91 



Duplicates Received: 
Illegal Messages Rcv'd: 
Illegal Slots Rcv'd 



n CM : ( 



LL 



me at ShL 



fc riu 



5, except that All hosts in 



the data base ate shown (not just authorized 

no i> t s j 
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F.fc Slices SfcR'VEK 



POSEIDON Sottyare VCl-001 



Microcode V01-001 



diagnostics V 01-001 



Address: AA-9L-0C-4 l J-* 1-0C 
Name: Harketmg Foe 
Location: BLUNG 4, SfcCT 

ii UiitU c L » jl i » 

Circuit Timer: 060 (080) 
Keepalive Tinier: 030 (030) 



Server Status: 
Terminal Status: 
tiardyare status: 
uptime (seconds) 
Softyare Status: 
Lump Host; 



000 000 000 000 000 000 



ouoo 
000 ceo 

F0 

1FE2-2700-1FD6C 
AO-12-00-lA-2b-01 



F • J S> i t U *% T c ^ fr i A * A L i i 



oa&e as Stttk TLi»ftifcAL # except that tetaiinai n's 
parameters ate cispiayec 
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APPENDIX G 
HELP DISPLAY FCRfefT 

G.i Non-privileged HELP Display 

LCCAL> ^fcLP 

The xollouinc; commands are available: 



cuNNhCT 

UEMh£ 

DTSCGKNFCT 



LGGGFF 
f ESUHt' 

SFT 



SHG«tf 
TEST 



tor ftore inlcr&aticn on a given cottnsaxiis type HELP command* 



G.2 Piiviieyec fc£LP Display 



; ; A s* _ L. L» C i» u • l„ C: L. r 

C i .} ii [i & C i L. U G U I* i* S O ] i 

u i'.i" iUt, L G u r 5iL,r 

LISCCNNFCT KESUfcE TEST 

INITIALIZE SET ^iiHQ 

*or more infcr&aticn on a yiven conmaiid* type fiELP coffiaancK 



G.3 Command HELP Displays 

- To ce provided/ toileting initial documentation release. 
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APPENDIX G - KtLP DISPLAYS 

AePENuIX h 
tfchCfi PfctChS&INC SUGARY 

o fatal Hardware Error -- Alert users* crash system/ invoke self-test 

o Fatal software Srror — Alert users, crash system, invoke sell-test 

o Ethernet Itansuiit Error (K1K¥) — Court error, retry 10 times, then 
alert users 

o Ltnernet &eceive Error (CkC) — Count error, and ignore message 

o Kthernet Hear to eat trror — If diagnosed at selt-test, ignore 
else count error and attempt to continue (higher level protocol 
toiil aiert users etc) 

o Utner Ethernet errors — Deline into classes; 

- Fatal hardware ferrot - Alert tsers/ crash systen*, invoke test 

- Network trior on Transmit - Count error, retry up to 10 
tines, then alert users 

- Network trrcr on Receive - Count error, ignore message ana 
continue 

- Miscellaneous non-tatal error - Count error and continue 

q UAhT i>arity/overrun/f raising error - Count error, ignore character 
ana continue. Error is not reported tc hosts 

o hu&an user snould re-type character 

o Nor-human input must have nigiier-ievel protocol with 
data verification, and retry operation upon error 

o UV «MM checksum erroi — Alert users, use system default parameters. 
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APPENDIX G - HELP DISPLAYS 



o heat aessase timeout -- «e ttar&mi t last message 10 times, tiien 
alert user^. If autoconnect enabled, attempt reconnection to host 



o Illegal host message -- take defcr virtual circuit, and alert users 
If 3utoconr.ee t enaMed, attetspt reconnection to nost 

o User input errcr in Local mode — Igncre input and issue error 

message 

o 10-second katchdog tiu.ee expires (hardware) — Simulate power-fail 
and invoke self -test 



POSEIDON Software Specification - CO&PANY CCNFILEfcTIAL Page 91 

APPEfcUJX G - BcLP DISPLAYS 

APPENDIX 1 
DOWNLINE LCAD PROCESSING 



PciStTDOh bottyate is doyniine loaded into the Terminal Server hardyare 
utilizing the standard Maintenance Operations protocol (MCP). The POSEIDON 
Downline lead procedure incorporates a RGK-baseti TERTIARY. LOADED/ which 
requests the PGSEIDCN software i&aye via the SGFTi*ARE_ID field in a REQUEST 

PROGRAM message. 

The loao process contains the lolloping steps: 

g Upcn successful self-test, a REQUEST PROGRAM message, specifying file 
t'£>G&0l£,hG«oV:> as the i>Ui , 'T*ARE_lLi, is sent to tne LOAD ASS'I»>IA«C£ 
volunteer milt least address. 

o Hosts systems that support this message yill read the 3GFTWAR£_ID 
lielu, and jrflTiiGlJT ACCl3SI1*G A DECnet DATABASE, yill attenpt to locate 
the file under the systes load default directory. For VAX/Vtt£ # this 

i- :v:LynTr!;;r::j:::L % ;c.SY:. it the nest tines tfce file, sn* wishes to 

volunteer loal assistance, it sends an ASSISTANCE VOLUNTEER message to 
tne requesting PlSLIUCN. Hany load nests &ay volunteer. 

o The PCShlOCN yiJ* then receive one or f.ore ASSISTANCE VOLUNTEER 
messages* It selects the FIRST menage, then senas a REQUEST PROGRAM 
message again, addressed to the selected load volunteer. 

o The load host then receives a REQUEST PROGRAM addressed specifically 
to it, and initiates loading. It sends a MEMORY LOAD message 
(containing the first record of the PfSEIDCN scftyare iuage) to the 

PGSEIDUM. 

o Upon each receipt of an in-sequence memory load record, POSEIDON loads 
mewory ther issues a REQUEST WEfcCRY LCAD aessage. 

o fchen the host receives a REQUEST fcEttORV LOAD message, it sends the 
next record of the PCSE1D0N software in a PEPORY LOAD message, ar\d so 
on until all records have ceen sent. At this point, the host sends a 

duasffly PAKAfrETER LOAD ^ITh TRANSFER ADLRESS record to tne POSEIDON. 

LL^D KITH TRANSFER ADDRESS, POSEIDON 
fiEtUEST MEMORY LGAu, then starts the 

final REQUEST MEMORY LOAD aiessage, it 
terminates tr;e lo«ia operation* 
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APPENDIX (, - HELP DISPLAYS 

APPENDIX J 
UPLINE hUHP PRCCESSINu 



Upon system crash, the PCSE1DUN memory image may De upline dumped to a host 
processor. This process utiiizies the standard Maintenance Operations 
protocol (yOP). 

The dump process contains the following steps: 

o Upon crash/ a bEQUEST DUfcP SfftVICE message, specifying file 
PSG801ENC.IMG as the SGt'TNA£E_ID, is sent the host system that 
downline loaded the software into the POSEIDON. It this host chooses 
to service tne cuup request, it issues a ttimUEST ii£..HGP¥ DUMP message 
to the PGSfclLOfo, and the next three steps are eliminated. 

o if the load host does not respond to the dtuap request within 10 

seconds, 1CSEIDCN kill issue a HECUEST DUXP SERVICE message to the 
LOAD ASSISTANCE volunteer multicast acdress. 

o hosts sy st errs that support this tnessaye aiil read the SGFT$ARE_ID 
iieid, ana « l T h C L T ACCiiS^I^G A DtCnet £hT hbAzi., kill attea^pt to verily 
whether they jup t ort dusip scryice. II the host yishes to volunteer 
ouiip assistance, it sends an ASSISTANCE ^ULUNTEEk atessage to the 
requesting PGSc.IDLN« f.any dunp hosts is ay volunteer. 

o The PGSEIDCN *ill then receive one or »ore ASSISTANCE VOLUNTEER 

me^sa^es. it selects the FIaST Mtessa^e, then sends a REQUEST DUMP 
ijEnVlCE message again, addressed to the selected load volunteer. 

o The dufflp host then receives a REQUEST DUMP SERVICE addressed 
specifically to it, and initiates duirping* It sends a REQUEST MEMORY 

DU&P iressage to the POSEIDON. 

o Upon each receipt of an in-sequence REQUEST ^ENCRi DUMP, POSEIDON 

issues a Mr;MCP¥ DUfcF message, containing linage data for the next 

section of memory to be dumped* All of POSfclDGN aeiaory, including 

code, is diifljped. 

o vhen the hcst receives a HEMCPV PWHP iressage, it stores the image in 
the next record of the PGSEIDCN duasp lile, then sends another REQUEST 
MEfcGfcY Dufcfr record to the PGSEIDC'N* 

o This continiues until the PGSEIDGN rurs out of memory to dump, at 
aihich time it senos a DU&P CC^PLfcTb message to the host. At this 
point, the -LofitLN *iii eitnei breaK-mto uui tor pcst-cumo analysis 
(if enchled), or start the diagnostic self-tept. 
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APPtfcLIX K 



HARLKARt K£QUIP£h£^TS 



o 68000 iiiicioprocessor (10 Mh'z), hhich effectively runs 
at 7*36 fehz. Clock period is thus 136 nanoseconds* 



o *ait sUtfcb are iiFipleaiented tor accesses to RON and fctf-RAM only. 
k»^ UAhTS and L/»NC£ accesses involve no wait states. 



o Lthernet CKA transfer rate is one yore per 1-6 microseconds 

( 1 U M h I- 3 } • 



u vvorst-case LANCh iseaory cycle time is teuO ns per yord, with 660 ns 

k » * t »r*» j t r ?^ i^ n r ** t >- k ; o r ^ k i Vi *"* v r 5 1 ir o *i e * ** o r 1 1"! e 1 5 s t 27? ns o t 
the &us arbitration/ the Crti way not access the bus. Therefore 
during I'^-A/ sutt«are effectively nay utilize only 47.8ti% of the CPU, 



o it is assun:ec that toe UArIS iiarscie iSiOO full duplex lju, and tnat 
the LANCE bandies 1C ¥\\z Ethernet traific without overruns. 



o It is assumed that an interrupt occurs for each input and output 
character, and on errcr and break conditions. These interrupts occur 

only alien the UAkT is ready, and at tfce designated vector and 
priority level. 



c It is assused tnat an interrupt occurs tor every packet received from 
the Ethernet (adoressec to the statior. or eesignated multicast 
addresses) . 
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AFi'ENLIX 2 

OUTSTANDING ISSULS 
The fclioioing issues remain outstanding iiith this release cf the Specification- 

3.1*3.99.1 Kxtent ot Autofcaud Functionality to oe defined after 

iaip fermentation 

1 . "1 . "2 . Q C 1 H a f 1 i- c± ?' c« c f i"> n f i n p c i r*r Initial ^fi rrt*«n an^ 

3.3-4.99.1 States Message Codes to be defined, 

11.0.99.1 Maintenance: Final strategy to be defined following Phase 1. 
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